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PREFACE 


The HUNTER microcomputer is a self contained and 
truly portable system. Its built-in operating system 
contains an accurate emulation of the wo rid -standard 
CP/M operating system and virtual floppy disk drive, 
implemented in RAM memory. Other built-in features 
include a powerful BASIC interpreter, a terminal 
emulation package, a flexible text editor with full- 
screen facilities based on the popular Wordstar and a 
comprehensive range of communications protocols. 
User memory is shared between work areas, program and 
data files. 


CP/M is a registered trademark of Digital Research Inc. 
Wordstar is a trademark of MicroPro International Corp. 



REPORTED 'BUGS' 


Some of the reported 'bugs' which existed in the system have been 

corrected. 

These are as follows: 

a) The format of the KILL statement in Basic has been extended to 

include the form Kill The use of 'name strings' in the 

NAME statement has also been included. 

b) The calls via Basic are also functioning correctly. This 
enables the call for the status of the serial port to be used 
again in place of the manual peeking of the communications 
pointers. 

c) The reported problems with IF THEN ELSE have been corrected. 

d) Machine code calls from Basic are also functioning. 

e) Line feeds are no longer echoed to the screen during LLOAD, 
LPRINT etc. 

f) The REM and ' have been separated out into separate tokens. 

g) Communications timeouts have been introduced. 

h) It is now possible to SAVE and LOAD both ASCII and Basic 
tokenised files from the Basic interpreter. 

i) In some versions of operating system, complex string expressions 
did lead to error. This has been corrected in the new version. 

j) In previous versions, the wand returned ’,' in place of in 
CODE39. 

There are still, however, some idiosyncrasies which as yet are not 

corrected in this release of the operating system, but these will be 

corrected when further releases are produced. 

a) WHILE-WEND requires that the WHILE is at the start of a line in 
Basic. 

b) There are some problems with the VAL statement in basic, e.g. 
VAL(".005") gives 0 not 0.005. 
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c) The SRCH statement does not function correctly with null length 
string. 

d) PRINT USING is not incorporated in this version of operating 
system. 

Your co-operation in reporting faults in the system is very much 
appreciated. Any discrepancies in the operating system or the 
associated documentation should be reported to the Husky office 
either by telephone or in writing. 

Users who have any strong feelings regarding any lack of facilities 
in the HUNTER would also be welcome to put forward their ideas. 
Although we cannot promise to include the idea into the system, it 
will be given serious consideration for inclusion in a later version 
if viable. 

There have been some updates to the operating system which are not 
dealt with in the current release of the HUNTER manual. the 
following is a description of the new changes. 

WAND 


In place of the wand menu on earlier versions, a new verb has been 
added to the BASIC in order to simplify the wand type selection. 
This new verb is WAND. 

setting wand=0 selects Code 39 bartype 

setting WAND=1 selects EAN 8/13 bartype 

WAND may also be used as parts of expressions, e.g: 

PRINT WAND 
PRIWr WAND»5 


The location may be poked direct ( BARTYPE ) 
TERMINAL MODE 


Terminal mode has now been provided with 
enable the user to exit and also to set the 
and return back to terminal mode direct. 


function keys in order to 
communications parameters 
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COMMUNICATION PARAMETERS 

to pro“d’e*a Umlfoit” optlo^n oT"both^“°"® .Parameters in order 
communications. These values can be se? from®?n'''® .S""’ 

In intervals of 10 secs. Unlike the nre/ i seconds to 1 minute 
disabled by selecting 'no' in the timeouts, they can be 

from the Port."* If*^ an* input Vs "no^^ requests an input 

time, then a communications error ^8' iTglven”^ ThVi ®P®PifIed 
to try again bv ore« 5 «iinD iyi ^ given. The user may elect 

input again for the sellcted time “i^ “alt for an 

received. selected time and timeout again if nothing is 

iVV'VenterrrL'doi'nV;^^^^^ ^ 

after the specified time tL hiintpV® handshake lines. If 
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Husky HUNTER is probably the smallest and toughest CP/M 
microcomputer ever made. 

It is resistant to moisture, dust, vibration, shock and electro- 
magnetic interference. But please don't abuse it. Inside the 
impervious cast aluminium case is some of the most advanced 
technology money can buy. Don't drop HUNTER needlessly, use it 
to strike other objects or pile heavy things on top of it. 

If you can't find the information you need in this manual or you 
have any problems with HUNTER, please call us. We've done all 
we can to make HUNTER a practical and utilitarian tool, not a 
frustrating Incumbrance. We hope you agree. After all, HUNTER 
is our baby. 


The HUNTER team 

HUSKY COMPUTERS LTD 
P 0 BOX 135 
3^5 FOLESHILL ROAD 
COVENTRY CV6 5RW 
ENGLAND 

TEL:(0203) 668181 
TELEX: 317^50 HUSKY G 


VER.V09F 


PAGE 1 - 1 



miRODUcnoN to humtcr 


SECTION 1.1 


1.1.2 HUITER 

Measuring 21.6 X 15.6 X 3.? cm (8.5" x 6.2" x 1.3") and weighing 
less than 1200g (31b), HUNTER is a completely self contained 
computer system. HUNTER is sealed against moisture, dust and 
other hazards. 

NEVER attempt to open the case - there are no user serviceable 
parts inside. 

The CP/M emulating operating system, now containing a flexible 
text editor, has RAM-disc emulation and provides a totally 
compatible environment for a vast range of commercially 
available software. 

HUNTER’S Basic interpreter has been specially developed to be 
compatible with other popular Basics and to meet the extra 
demands of e portable system. Special statements, for example 
to filter input data so that only formats consistent with the 
program are accepted, simplify user programming. 

Communications with instruments or computers, Including main- 
frames, are user programmable. Protocols can be chosen from a 
wide selection, including a choice of synchronous or 
asynchronous types. 

CP/M compatibility is an important feature. A large range of 
commercially available software, including packages such as 
spreadsheets, can now be run on HUNTER with no modifications. 

Disk emulation in RAM memory allows standard prr^rams such as 
WordStar and SuperCalc to run without modification, while files 
can be exchanged easily. 


WordStar is a registered trademark of MicroPro International 
Corporation. 

SuperCalc is a registered trademark of Sorcim. 

CP/M is a registered trademark of Digital Research Corp 
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SECTTQN 1.2 


USING THE MANUAL 


1.2.1 


1.2.2 


Tlds manual is intended to fulfil several functions. 

fJe operation, programming and 

2) As a source of reference for technical data about HUWTER. 

3) As the vehicle for achieving HUNTER'S full potential in 
diverse user applications. 

® computer or 

refirrpd gt^idance on these subjects, the reader is 

referred to the many excellent introductory works dealing with 
microcomputer Basic, now commonly available. 

HOW TO USE THIS MANUAL 

The manual is split into a number of parts. Part 1 is this 
introduction. The others are: 

2) HUNTER Operation: 

Description of HUNTER - its File Manager, communications, 
virtual screen and setting of the internal clock/calandar. 

3) File Manager: 

Ascription of HUNTER'S File Manager DEMOS (Disk Emulation 
Operating System) and CP/M compatibility. 

4) Basic Programming: 

Description of HUNTER Basic Programming techniques, use of the 
Basic Editor plus listing of error and warning messages. 

5) Basic Functions: 

Detailed explanation of the resident HU^r^ER Basic interpreter 
commands. 

6) Communications: 

Full description of HUNTER'S flexible serial data communications 
facilities. 

7) HUNTER Text Editor: 

Instruction in the use of the text editing facility within 
HUNTER. 
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nmioDUCTioN to humter 


SECTION 1.2 


8) Maintenance and Accessories: 

Instructions for case sealing, pressure relief etc., and 
information of accessories available for Hunter. 

9) Appendix: 

Specification, code conversion tables, etc. 

10) Index: 

Alphabetic index to pages. 

The contents of each section are listed on the first page following 
the divider. 
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INTRODUCnON TO HUHTER 


SECnON 1.3 


1.3 


PAGE FORMATS 




appears HUOTEB-s operating 3ysten,%evisTon number^to wh^ this 
manual refers) to the left and the page number to the right. 


manual being studied, the second to the page number 
referenced from the start of each part. 
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HUNTER OPERATION 


CONTENTS 
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2.2 FILE MANAGER DISPLAY 

2.3 HUNTER SYSTEM FILES 

2.4 KEYBOARD 

2.5 SCREEN 

2.6 VIRTUAL SCREEN 

2.7 CCMMUNICAHON 

2.8 BATTERIES 

2.9 PANIC! 

2.10 BATTERY LIFE 




HUNTER OPERATION 


SECTION 2.1 


Fig 2.1 HUNTER LAYOUT 
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HUNTER OPERATION 


SECTION 2.1 


2.1.1 


SWITCHING ON 


TO owitch HUNTER on preoo tHe 

^u^'^p-rY-oEroH^R -rr rs 

re??^He*’rlTroSinr~ 


Fig Z2 *WELCOME MESSAGE* 


9%) 

HUSKY°° 

HUMTER 

press any key... 


2.1. 1.1 


If all is not well and the above display does not appear, it 
could be for one of the following reasons. 


Display needs adjustment: The Liquid Crystal Display (LCD) used 
in HUNTER can vary its angle of display to suit various opera- 
ting positions. This is obtained by pressing CTL/FN 
(control/function) and either the cursor up or cursor down keys 
until the desired display angle is found. 


2. 1.1.2 Auto start program loaded: A program has been entered into 
HUNTER to automatically run when ever it is switched on. If this 
is the case the operator should be prompted by HUNTER or have 
been informed what to do next. 


If neither of the above produce a response, check the PANIC 
section 2.9 for further information. 


2.1.2 SELECTING TIC FILE MANAGER 

Having obtained the above ’Welcome Message* HUNTER'S File 
Manager is entered by pressing any key. The screen will then 
display HUNTER'S various system programs, any of which may be 
selected by operation of the appropriate function key. 
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HUNTER OPERATION 


SECnON 2.2 


FILE MANAGER DISPLAY 


2.2 HUNTER'S File Manager, called DEMOS 2.2 (Disk EMulation 

Operating System version 2.2) is obtained by procedures 
described above. 

2.2.1 FILE MANAGER SCREEN 

Following power up the File Manager screen looks like this: 
(Some versions may vary. This is a typical example) 


29 NOV 1983 09:50 
** DEMOS VER 2.2 9.A»» 

BAS .sys CCMS .sys CLCK .sys 

TERM .sys EDIT .sys 


DIR STAT BAS CCMS CLCK TERM EDIT KEYS 


NOTE: Only system files (.SYS extension) are displayed. Further 
files can be displayed with the *DIR' command. The time display 
does not update to conserve power. 

The function keys are programmed as follows: 

1. DIR (File directory) 

2. STAT (File status) 

3. BAS (Basic interpreter) 

U. COMS (Initialise communications) 

5. CLCK (Initialise clock) 

6. TERM (Terminal emulation) 

7. EDIT (Text Editor) 

8. KEYS (Alternate function keys) 

The function 'KEYS' displays an alternative menu. See below. 

DIR STAT INP SAVE TYPE REN SEND KEYS 

Functions can be selected by either the appropriate function key 
or typing the longhand version. 
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hunter operation 


SECTION 2.3 


HUNTER SYSTEM FILES 


2.3 HUNTER'S system files are not true files in the CP/M sense. They 

are built-in utility programs designed to support use of the 
computer. The function of each is described below. 


2.3.1 FILE DIRECTORY 

Displays a list of filenames. The use of wildcards is 
supported. See section 3.^.3, WILDCARDS. 


2.3.2 FILE STATUS 

This function displays the file status, read/write or read only, 
file size and remaining file space. See section 3.^.3. 16, STAT. 


2.3.3 BASIC INTERPRETER 

Access to HUNTER'S Basic interpreter is provided with this 
option. See Part ^1, BASIC PROGRAMMING. 


2.3.4 INITIALISE COMMUNICATIONS 

The parameters of HUNTER'S industry standard RS-232/V24 
interface may be changed for compatibility with additional 
external equipment. See Part 6, COMMUNICATIONS. 


2.3.5 INITIALISE CLOCK 

The date and time of HUNTER'S internal calendar clock may be set 
with this function. Calendar maintenance is completely 
automatic once the correct date and time have been entered. See 
section 3.4.3.2, CLCK. 


2.3.6 


TERMINAL EMUUHON 


HUWER emulates a simple CRT terminal. The communications baud 
rate and protocols are first initialised with 'INITIALISF 
COMMUNICATIONS' function. See section 6.8, TERMINAL EMULATION. 


2.3.7 EDIT 

This activates the text editor. See section 7. 
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HUNTER OPERAHON 


SECTION 2.3 


2.3.8 keys 

Operation of the function »KEYS' displays the alternate function 
key display line, as follows: 

DIR STAT INP SAVE TYPE REN SEND KEYS 

Further operation of the function 'KEYS' will return HUNTER to 
the original function key display line. 
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hunter operation 


SECnON 2.H 


KEYBOARD 


2 ,^ 


2.U.1 


2.^4. 2 


2.41.3 


standard QWER'nT'^2>3°itTora * bu^ 

such as PWR, ESC and the iursor^e^s. non-standard keys 

per"si’cond'°“"’ anto-repeat at about 8 oharaoters 

POWER AM) HELP 

Used for switching HUNTER on and off. 

5^pe?’aufjus? f^^we^r o*n"?o^? hirb ’ " 

for help. It is necessary to press -Shift Power- to" tu7n HUNTCR 
EITTER 

Sr o5r ^ tensdnating input from the keyboanl 

used S'^HUWTEr'^ii’i ®t°-. the EWER key 'is not 

used as HUOTER will respond automatically to keyboard input. 

?un?tior™' i^%n°t7<fr^“*^ -- Ptosrams. The 

SHIFT 


This key accesses the legends on the upper half of the keys and 
must be used in combination with another key. The keys A-Z 
produce upper case with the shift key. ^ ^ 

2.4.4 CURSOR KEYS 

The cursor control keys perform a number of functions including 
adjustment of viewing angle, moving the virtual screen window al 
well as moving the cursor. 


2.4.5 DELETE, BACKSPACE AND BACKARROW 

Delete, backspace and backarrow keys within DEMOS and Basic all 
perform the same function, i.e. deletes the character to the 
left of the cursor. Some user programs in CP/M may use 
backspace differently by not deleting the character, but only 
moving the cursor back. ^ 
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HUNTER OPERATION 


SECTION 2.4 


2.4.6 CONTROL 

This key is similar to ’shift' in that it generates a new set of 
ASCII codes. 

By holding down ’CTL’ and pressing an alphabetic key, a control 
code is generated e.g. 'CTL A' clears the screen and 'CTL G 
sounds the bleeper. (Note: this function is inhibited in the 
file manager). 

Another use of control is for adjustment of the LCD display 
viewing angle. By pressing 'CTL' and either up or down arrow 
the viewing angle may be changed to suit the user. This function 
is always active. 

2.4.7 FUNCnON KETS 

The CTL/FN key may also be used to generate key sequences known 
as function keys. These strings may be used for frequently used 
commands and are present within system programs (DEMOS, Basic, 
etc.) They are operated in a similar fashion to control, but 
pressing a numeric key 1-8, giving the eight function keys. 

The commands implemented are displayed on the bottom line of 
display (this may be turned off, see the LBL key). 

Within Basic programs the key may be initialised to new 
functions, see section 4.5.4 FUNCTION KEYS. 

2.4.8 ESCAPE AND BREAK 

'ESC is an upper-shifted key used to break into and terminate 
execution of HUNTER Basic. 

'BREAK' (BRK) is used to interrupt a Basic program. See 'ON 
BREAK' in Part 5, BASIC FUNCTIONS. Break is also available for 
CP/M programs and in terminal mode. 


2.4.9 INS AID LBL 

'INS' will return the virtual screen window to its original 
position. 

'control INS' will reverse the operation of the 'SHIFT' key on 
the characters A - Z, providing a 'CAPS' function. 

'LBL' switches the function line display on and off. LBL is an 
upper shifted key. 
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hunter OPERATION 


SECTION 2.4 


2.4.10 


2.4.11 


2.4.12 


-e and long life. The 
Objects. ’ ^ damaged by impact with sharp 

KETBOARD RE-DEFINIHON 

l\li up HUOTER, the keyboard 

tt:: re-dermitlon occu^^L^^h^^t'l^e" 

SPECIAL CODES 


Special codes are assigned to keys whose njnotlons are; 

(1) Control key 

(2) Shift key (latched) 

(3) Help key 

(4) Momentary shift key 

(5) Power On/Off key 

(6) Virtual screen window up key 

(7) Virtual screen window down key 

(8) Virtual screen window right key 

(9) Virtual screen window left key 

(10) Virtual screen right 

(11) Virtual screen left 

(12) Label key 

(13) Insert key 
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HUNTEB OPERATION 


SECTION 2.^ 


In order for the operating system to <ieteet a change of the« 
keys, the SPELFLG location must be cleared. Changes modirying 
the special codes should only be done under software control. 

NOTE: ’Enter' is not a special code: it is simply CR (Decimal 
13) I 

UTOCD SHIFT CODE 129 (81H) , . ^ 4-« 
This key should be defined in both shift halves in order to 
function correctly! This function gives a 'toggle' action, 
changing shift with each operation. 

MOMENTARY SHIFT CODE 130 (82H) ^ 

As HUNTER powers up in the lower shift, it is important for the 
momentary shift code to be defined in the lower shift half of 
KEYBUF. This function gives a 'conventional' shift requiring 
simultaneous depression of shift and the desired key. 


CONTROL CODE 132 (RMH) 

On detection of this key the control code for the key pressed is 
derived from the code located in the upper shift half of KEYBUF, 
if this key has a valid 'control' equivalent. 

COITTROL CODE 133 (85H) 

On detection of this key the control code for the key pressed is 
derived from the code located in the lower shift half of KEYBUF, 
if this key has a valid 'control' equivalent. 

HELP CODE (86H) 

The detection of this key causes the firmware to enter the HELP 
text mode. Help mode is exited by pressing the 'HELP' key 
again. 

ON/OFF CODE 136 (88H) 

The power on/off key may be relocated to any position on the 
keyboard. After HUNTER has been powered off the power key 
defaults back to the top right hand position of the keyboard. 

VIRTUAL SCREEN WINDOW UP CODE 138 (8AH) 

VIRTUAL SCREEN WINDOW DOWN CODE 139 (8BH) 

VIRTUAL SCREEN WINDOW RIGHT CODE 1M0 (8CH) 

VIRTUAL SCREEN WINDOW LEFT CODE I'll (8DH) 

The above keys allow the user to view the contents of the 
virtual screen. The keys are completely transparent to the user 
program. 

LABEL CODE 1^13 (8FH) 

Switches the function key display line on and off. The key is 
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SECTION 2,H 


transparent to the user program. 

INSERT CODE 1^i| (9GH) 

Re^ms the virtual screen window to its original position after 
being moved by the window control keys. The key is transparent 
to the user program. 

2.i4.13 ON/OFF KEY 

Unlike most computers, HUNTER'S ON/OFF switch is not actually in 
control of power removal. The key is seen by the software 
scanning the keyboard and the actual decision to turn off is up 
to the software itself. 

If a machine code program places HUNTER into an endless loop, it 
will be impossible to turn off the machine. This may be 
overcome by removing the main batteries. 
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SECTION 2.5 


SCREEN 


2.5.1 HUNTER has a large LCD (Liquid Crystal Display) screen. It can 
present up to 320 characters on 8 lines of 40 characters each, 
just like a small video terminal. 

The character set includes upper and lower case alphabets and 
special characters. Additionally, a graphics display of 240 x 
64 pixels is supported. 

HUNTER'S display is designed for use in bright sunlight where 
other displays (the red 'LED' or green 'vacuum flourescent', for 
example) become Invisible. 

Because it works by contrast, rather than emitting its own 
light, it is perfectly visible no matter how bright the light 
is. But a word of caution: try to avoid leaving HUNTER exposed 
to direct sunlight for prolonged periods - the delicate 
chemicals in the LCD can be damaged. 

The 'Cursor' shows where data entered on the keyboard will 
appear. 

The screen is protected by an acrylic window, as strong as 
glass. Like glass, it can be scratch^, so please take care. The 
window should only be cleaned with chamois or lens cleaning 
cloth. 

HUNTER is built to last - please take care of It. 

2.5.2 SCREEN MODES 

The screen can be used in two ways: 

: Text mode 
: Graphics mode 

Text mode provides only character support w1,th the standard 8 
lines of 40 characters displayed. Internally, there is a 
"virtual screen", see section 2.6, supporting 24 lines of 80 
characters. This mode can support any standard CP/M program, 
e.g. SuperCalc or dBase II. It can be used in this fashion due 
to the speed at which the LCD screen can be refreshed in this 
mode. This is the only mode supported for CP/M based programs. 

Graphics mode will support characters of five different sizes, 
reverse video and full graphic capabilities. There is no 
"virtual screen" associated with this mode. It is only 
supported from Basic, see section 5. 
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2.5.3 Screen Control 


vertically! ^ ^ ^ ° ^ horizontally and 0 to 23 

L“s»sr‘T. s “ "» 

Cursor addr control, x-coordinate, y -coordinate 
The cursor address conrol is OFH (15 dec). 

■Hie x coordinate is a nunter 0 - 79. 

The y coordinate Is a number 0 - 23. 
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VIRTUAL SCREEN 


2.6 The eight by forty characters on the LCD are only one sixth of 

the number of characters contained within the virtual screen. 
The LCD acts as a window onto the virtual screen. The contents 
of the virtual screen may be inspected at will by using the 
cursor control keys in their shifted state. 


2.6.1 SCREEN SIZE 

HUNTER'S virtual screen is 80 characters by 24 lines. The 
virtual screen behaves very much like a terminal with automatic 
scrolling. When the cursor reaches the bottom line, the rest 
scrolls up losing the top line. 


2.6.2 MOVING THE WINDOW 

The window may be moved over the virtual screen either manually 
by the user, or automatically by the virtual screen handler 
resident in the operating system and as such is transparent to 
the user. 

2.6.2. 1 Manual Movement 

1) Shifted state cursor control keys (looking keys): 

By using the cursor control keys in their shifted state, the 
window can be made to move in the direction marked on the key, 
i.e. press the 'shift' key, hold it down, and then press the 
desired cursor control key. When this operation is performed it 
will be noticed that the cursor on the LCD (a blank flashing 
block) will change its position on the LCD and quite often 
disaRjear. This will happen because the cursor position refers 
to the position in the virtual screen, and when the window is 
moved the cursor position relative to the window position in the 
virtual screen will change. 

2) Function "cursor control keys" 

By pressing CTL/FN and either horizontal arrow key, then either 
the left or right 40 characters of the screen can be seen. This 
function is useful for easy reading of wide screen formats. 

3) 'INS' Key: 

Pressing the INS key will return the window to its original 
position prior to use of the looking keys, as outlined in (1) 
above. 
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4) Transparent Movement: 

The transparent movement of the virtual screen window is 
primarily controlled by inputs, both from the keyboard and the 
serial port. If HUNTER is required to accept an input from, 
say, the keyboart then the window will automatically be moved to 
allow the viewing of the immediate area of the virtual screen 
centred around the present cursor position, thus displaying any 
prompts which may have been required by either a Basic program 
or a CP/M type program. 

It must be noted that printing text onto the virtual screen will 
not move the window. However, if any part of the virtual screen 
which is presently in view on the LCD is changed by, say, a 
PRINT statement, then these changes will be reflected on the 
LCD, thus always giving a true representation of the virtual 
screen. 

If HUNTER is accepting input from the keyboard and the cursor 
reaches the forty-first position of the virtual screen, then the 
window will be moved laterally so that the cursor is now 
positioned mid-way across the LCD, as soon as the forty-first 
character is entered, thus displaying the previous 20 virtual 
screen characters and the following 20 virtual screen 
characters. 

If HUNTER is waiting for input and the looking keys are used to 
move the window, a valid input will cause the window to 
automatically revert to its original position prior to the use 
of the looking keys. This facility does not force the user to 
press the 'INS' key in order to restore the original position of 
the window when in this mode. 

For further information on cursor addressing see LOCATE in Part 
5, BASIC FUNCnONS and section 2.5.3. 


NOTE: The virtual screen window does not operate in Graphics 
mode. 


2.6.3 MOVING THE CURSOR 

To move the cursor in the required direction it is only 
necessary to press the appropriate cursor control key. 
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Fig 2.^ VIRTUAL SCREEN 


80 


S 


s 

40x8 CHARACTER WINDOW 0 


24l 


80 by 24 VIRTUAL SCREEN 


note The shifted cursor control keys EBBS move the 
window over the virtual screen in the direction 
of the arrows. 
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2.7 


COMMUNICATION 


P^tf and serial communications 

models and other devicel ^'^ peripherals. 

Fig 2.5 MALE (HUNTER) 



ISTSiiSSS"''"”” " 

Fig 2.6 FE>1ALE (CABLE) 
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If the connector won't fit easily, it probably won't fit at all. 
FDD OUT WHY 

HUNTER'S communication format is usually set up by its 
applications program for specific situations, and does not 
require operator attention. 

Sometimes, a user program will present a 'menu' selection for 
operator choice. In this event, selection of the desired 
communications mode will automatically set the communications 
parameters without further action. 

Communications parameters can also be set manually. An internal 
program, 'COMMUNICATIONS PARAMETERS', can be accessed or called 
by a user application program. See Part 6 COMMUNICATION, for 
details. 
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BATTERIES 


2.8 HUNTER is battery powered. It runs for a long time on a set of 

standard 'AA' size cells obtainable anywhere. 

A second rechargeable battery is permanently built into HUNTER 
so data is not lost even if the main batteries are removed. This 
battery should never need to be replaced. 

2.8.1 BATTERY INSTALLATION 

The batteries are spring-loaded to make contact and retained by 
a threaded plug. When installing batteries, follow this 
procedure:- 

1. ONLY USE A COIN in the battery plug. Screwdrivers, 
etc., will damage the slot and HUNTER'S appearance. 

2. Feed in the cells, positive inwards. Don't drop the 
'AA* cells in vertically - they can be damaged. 
Instead, slope HUNTER slightly. 

3. Take the battery plug and, with finger pressure only, 
press into the battery compartment and turn. 

y. Only when the thread is started, use a coin to screw the 
plug home. 

The battery plug should stand about 2mm proud from the case 
wall. 

NOTE; Clockwise inserts the plug 

Anti -clockwise removes the plug 


2.8.2 MAIN BATTERY - PRIMARY 

We strongly recommend the use of Alkaline-Manganese batteries 
similiar to Mallory MN1500. 

We do not recommend the use of cheaper zinc-carbon cells for 
routine operation, since these can suffer electrolyte leakage, 
have shorter lives and can introduce technical problems. 

Alkaline cells will produce approximately 45 hours of HUNTER use 
when running a typical application program, and almost 
indefinite storage life. There is no need to remove cells from 
HUNTER during storage or shipment but remember that capacity 
will reduce with time. 


VER.V09F 


PAGE 2-20 


hunter operation 


SECnOW 2.8 


2.8.3 BATTERY - RECHARGEABLE 


circumstances must* any other "o 
We recommend Bereo type NCC50 c^lls of ?M mwf ceVclll ^""taned. 

2.8.4 Low Battery Warning 

“e'lnn!rpr?teS%fd"'r '’att.ry 

This warning faoilltv worst situations. 

Ver.% Ms operating systems 

uslr.'^orit‘’l“us'^^^^^ f wo'TUngs to the 

rechargeables are fitted put on O'-- "• 

Low Battery warnings are repeated as follows: 

a) every 5 seconds if the HUOTER Is switched on, but quiescent. 

b) after every keyboard key depression 
or, 

TOrt^ s®<^onds if characters are being received on the RS232 
If ten consequentive warnings are ignored HUNTFr anfnm..., ,, 

«OT^df(kee“s«t?on " 

sr, s: T.S'£".SS; s 4: sr «>■ 

a) Text Mode 

dfsTlaysf " <'«t®=ted, the top line of the screen 

« WARNING BATTERIES ARE LOW » 

™xt':a®?n^^g“!'® wntil 
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The text screen contents are preserved and not affected by the 
warnings. Following power restoration, the screen is restored 
to its pre-warning state. 

b) Graphics Mode 

When a low battery is detected, the top line of the screen 
displays: 

• WARNING BATTERIES ARE LOW » 

in reverse video and using the smallest character set (CHARO). 
This message stays on the screen between battery warnings. 
HUNTER also bleeps twice. The warning message destructively 
overwrites the top line of the screen, the contents of which are 
lost and must be restored by the user’s program. 

If an attempt is made to use HUNTER without replacing or recharging 
the batteries. Battery Low warning is displayed and HUNTER 
immediately turns off again. It is worth commenting that flat 
batteries can partially recover after being switched off such that 
operation could continue for a short period. It is not recommended 
that this should be done in practise, particularly with rechargeable 
batteries which could then become totally exhausted. In the case of 
Ni-Cd batteries, this can lead to permanent damage to the cells. 


2.8.5 POWER SAVE 


An automatic power conservation system has been incorporated into 
HUNTER, enabling the power to be removed from circuits when they are 
not in use. 


Usually, the computer will enter power save mode whenever it is 
awaiting a keyboard entry. However, a few programs defeat this 
facility by not using standard CP/M console calls and have a 
correspondingly higher overall power consumption. Please consult 
Husky Computers for advice in specific cases. 


2.8.6 


BATTERY CHARGING 


HUNTER is optionally available with rechargeable cells and a mains 
(line) powered charger. 

This arrangement allows cells to be recharged in HUNTER, and for 
alkaline cells to be quickly substituted if the user foreets to 


But BE CAREFUL - NEVER connect the charger when alkaline batteries 
VER.V09F 
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are installed. They will NOT re-charge. Instead, they may explode, 
jam in the battery tube or leak corrosive chemicals. 

See section, 8.6, BATTERY CHARGER, for further information regarding 
the use of HUNTER'S battery charger. 

2.8.7 CONTINUOUS CONNECTION 

HUNTER can be powered permanently from the charger by simply leaving 
the unit connected. In this mode, the rechargeable cells will be kept 
'topped up' by the charger despite the continuous current drain. Of 
course, a fully discharged battery will take longer to recover than 
if HUNTER is powered down. 


2.8.8 Auto Timeout 

To conserve battery life, HUNTER will automatically switch off after 
a period of inactivity. A warning bleep is emitted every 2.1/2 
minutes to remind the user that HUNTER is turned on. This timeout 
does not operate in Terminal Emulation (see section 6.8). The 
timeout value can be modified using POWER in Basic (see section 
5.17.7) and has a default value of 5 minutes. 
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2.9.1 


2.9.2 


PANIC 


^ tested for robustness in 

every sense including robustness of program execution. 

HUOTER's microprocessor system has wide design tolerances (much 
.o'*" conventional computers) to guarantee absolutely 
<n.r execution of millions upon millions of machine-code 
instructions every hour. Its physical construction protects it 
disturbance, while the conventional 
■ “temal electrical interference - is 

Virtually eliminated. 

Because of these factors, HUNTER is most unlikely ever to mis- 
exeoute a user's program or behave in a way that is not 
thoroughly predictable, given sufficient insight. 

CRASHES 


specific situations that can cause 
HurfTER to mis-execute its internal programming, or "Crash”. 

The commonest causes are: 

2.9.2. 1 Illegal System Calls 

System calls from Basic are not 'trapped’ (this would restrict 
user programming) and can cause mis-execution if not valid. 

2. 9. 2. 2 Invalid user machine code 

User assembly-level programs or subroutines can easily cause 
mis-execution by containing, for instance, invalid jump 
instructions. 

2. 9. 2. 3 Physical degradation 

Ingress of water, corrosion of internal parts, damage to 
components through excessive shock or persistent high level 
vibration can reduce electronic tolerances. 

2. 9. 2. 4 Operation outside specified temperature range 

HUNTER is specified for operation in the range 0 to 55®C. 
Operation above 55°C reduces tolerances, while below 0°C battery 
capacity becomes severely restricted. Sub-zero temperatures 
also slow LCD screen response time substantially. HUNTER is 
unlikely to mis-execute program simply because of low 
temperatures, however, in the range 0®C to -20®C. 
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2.9.3 

SYMPTOMS 

"Crashes" are identified by these symptoms; 

2. 9. 3.1 

Keyboard Lock-out 

HUNTER'S keyboard is entirely "soft" to allow user re-definition 
of key functions, including the power key. If HUNTER'S internal 
program is caused to 'Crash', power control may be lost, HUNTER 
will not switch off. 

2.9.3.2 

Clock wipe-out 

Following a mis-execution episode, HUNTER'S calendar clock 
registers may be corrupted. 

2.9.3. 3 

Program Corruption 

The most serious consequence of mis-execution is when the micro 
processor runs 'wild', writing data randomly to all parts of 
memory and, occasionally, corrupting user programs. This failure 
is generally catastrophic, and is unlikely to go undetected. The 
most likely consequence is that any attempt to 'RUN' the 
corrupted program will result in keyboard lock-out (see above). 
Attempts to 'LIST' corrupted programs may also result in lock- 
out. 

2.9.3. 

lA) Corruption 

I/O selections may be affected by mis-executions in a random 
fashion. In some cases spurious options may appear in the 
parameter selection screens after a 'Crash'. In this event, 
hold down one of the cursor control keys until recognisable 
options appear. 

2.9.^ 

RECOVERY 

2.9.^. 1 

Program Corruption 

If a mis-execution has occurred, any user program stored in RAM 
memory must be viewed with suspicion. The safest solution 
assuming that the use of keyboard is still available, is to type 
'NEW, followed by re-loading of the program. 

Remember that even 'LIST' may result in keyboard lockout 
although holding the power key down will generally restore 
control eventually. 
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Most types of corruption (corrupted lines, spurious line 
numbers) are unrecoverable in Basic and can only be eliminated 
by *NEW. 

2.Q.^.2 Keyboard Lock-out 

If keyboard lock-out (failure to power down) occurs, it is 
necessary to power down HU^^^ER by removing the battery cap. 

HUNTER should power-up again normally. If desired, try running 
the user program, but be ready to clear any lock-out that occurs 
using the above methods. If lock-out persists, type 'NEW after 
restoring operation. 

2. 9. ^.3 System Lock-out 

In very rare cases, HUNTER may fail to restart correctly after a 
mis-execution episode. This is possible in a program that uses 
auto-start, see section ^.12, AUTO POWER FEATURE, and contains 
an invalid system call. 

Any program corruption resulting could leave the auto-start flag 
set, but cause a lock-out when power-up is attempted. 

The solution is to apply the 'ESC sequence immediately after 
power-up, in order to reset the auto-start flag. 

2.9. ^.^ File corruption 

Because files are not stored in Hunter's workspace (RO) area, 
mis-execution episodes are much less likely to cause corruption 
of this part of memory. In any case, the checksum facility 
will indicate if damage has ocurred. Current experience 
suggests that storing a 'back up' file in a different memory 
page virtually guarantees data integrity against the worst 
possible disasters. 


A checksum error can result in a "no file" message being 
displayed in response to an attempt to use the file, even if the 
directory entry is present. In this event, the only recourse is 
to re-load the file. 
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P.10 BATTERY LIFE 

2.10.1 HUNTER’S power control system is designed to act^ity^^^^^is 

adaoting power consumption to the computer's level of act ivi^. u 

accuracy the expected life of a set of batteries. 

2.10.2 Battery capacity is measured in mAH (milliamp hours) and by knowing 
the battery type in use, life may be calculated. 

Battery capacity is affected by a number of factors including age, 
charging method, ambient temperature, However 

typically available from the two types of battery used by HUNTER is 
as follows: 


a) DISPOSABLE 


Duracell type MN1500 (I.E.C. LR6) capacity 900 
mAH. 


b1 RECHARGEABLE Berec type NCC50 (I.E.C. KR 15/51) capacity 425 


Because capacity can vary significantly, the application planning 
should always assume reduced available capacity. There are no firm 
guidelines for this, but 50% of capacity is considered conservative. 


A factor affecting apparent battery life is the 'end point , or 
voltage at which the battery is considered to be exhausted. Hunter 
sets this end point at 4.6 - 4.8 volts for battery warning. 


This value yields virtually 100% of Nickel Cadmium batteries capacity 
and gives good results for Alkaline cells, but means that 
manufacturer’s specifications for capacity may some times be 
misleading. 


2.10.3 HUNTER'S power consumption has three principal modes: 


a) POWER SAVE 15mA 

(awaiting keyboard or serial port entry) 

b) OPERATING 90raA (208K) 

(running a program for calculation, data storage, screen updat- 
ing or any operation involving continuous execution of user 
program). 
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c ) COMMUNTCAHNC 

(connected to a fully equipped 125mA (208K) 
RS232 port and 115 mA ( 8 OK) 
operating) 


screen is on and the keyboard responsive to any key depression, this 
is the condition in which HUNTER is expected to be most of the time. 


A typical application example might be a salesman using HUNTER for 
order entry purposes at a number of customer's premises ^d returning 
to base for communication. 


2.10.4 Example of Power Consumption 


The day is 7.5 hours long, during which he makes five calls. At each 
call he uses HUNTER for 40 minutes for stock checking and order entry 
purposes. The communication time takes 15 minutes, with a further 5 
minutes left powered up. 


Of the 40 minutes use at each call, only 5 minutes is considered 
•operation' since most of the time HUNTER is waiting for keyboard 
entry. 

Each Visit 


Operating Power 80 x 5 

60 

= 6.67 mAH 

Power Save Power 15 x 35 
60 

= 8.75 mAH 

Total Visit Power 

= 15.4 mAH 

Total Day's Power: 

5 visits at 15.4mHA 

= 77 mAH 

Communicating 115 x 15 

60 

r 28.75 mAH 

Waiting after corns 40 x 5 
60 

= 3.33 mAH 
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Day Total = 109 mAH 

Total Time in use through the day: 3 hours ^0 minutes. 

It would be expected that the HUNTER would last approximately 4 days 
(or hours 40 minutes total) on a set of rechargeable cells. 
Alternatively, HUhTTER would last 10 days (or 36 hours 40 minutes) on 
a set of manganse alkaline cells. 
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BATTERY LIFE 

A chart of the current used by a HUNTER may be shown as follows: 



This illustrates a period of use of the HUNTER. In practise, the 
periods of power save are much longer than that illustrated. 
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DEMOS -FILE MANAGER 


HUNTER'S file manager DEMOS (Disc EMulation Operating System) 
manipulates files and runs CP/M programs. A large range of 
commercially available CP/M software will run on HUNTER with no 
modification 


After switching HUNTER on, the 'Welcome Message' is displayed 
and the following screen can be obtained by pressing any key: 


20 Jan 

198^ 13:04:27 


»»DEM0S VER 

2.2 9.A»* 


BAS . sys 

COMS .sys CLCK 

.sys 

TERM .sys 

EDIT .sys 

DIR STAT BAS 

COMS CLCK TERM 

EDIT KEYS 


The bottom line shows the titles of the soft keys. See section 

2.2, FILE MANAGER DISPUY. 

The File Manager has several important functions: 

(1) All programs such as word processors, spreadsheets and the 
Basic Interpreter are run from the File Manager. 

(2) Various system files can be selected, for example, setting 
up the communication protocols. 

(3) Information on the size of the files present (STAT) or file 
operations like transmitting a file (SEND) can be 
performed. 
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3.1.1 FILE NAMES 

Files are named following the general format of CP/M. They 
consist of up to eight alphanumeric characters separated by a 
period from an extension of three alphanumeric characters. The 
extension informs the operating system of the type of file, if 
the user so wishes. Generally, the extensions follow these 
conventions: 

.HBA - HUNTER Basic file containing program source code. 

.COM - A CP/M compatible object code file which can be 
loaded and run independently of HUNTER Basic. 

.DTA - HUhTTER Basic data file. 

.TXT - Any ASCII text file. 

.SYS - A 'psuedo file’, generally in ROM. 

3.1.2 KEYBOARD COMMANDS 

By use of the control key together with another key the editing 
functions, see TABLE 3.1 KEYBOARD COMMANDS, can be implemented 
under the File Manager: 


TABLE 3.1 KEYBOARD COflANDS 


'control C 
'control E' 
'control H' 
'control J' 
'control M' 
'control R' 
'control U' 
'control X' 


Reboots when at the beginning of the line. 
Causes physical end of line. 

Backspace one character position. 

(Line feed) terminates input line. 

(Return) terminates input line. 

Retypes the current line after new line. 
Removes current line after new line. 
Backspace to beginning of current line. 


VER.V09F 


PAGE 3-2 


file MANAGER 


SECTION 3.2 


PROGRAM EXECUTION 


Hanger In S-h may be run from the File 

/ a Is loa<*e<l into the working 

dtrecUv interpreter o^ 

MM a program files are stored together in 

RAM file space, and are treated as if they were stored on disk. 

3.2.1 BASIC PROGRAMS 

HUfn-ER Basic programs can be run without explicitly invoking the 

ov program to be loaded and the interpreter to 

be executed. For example, if the directory reads as follows: 

M)IR 

PR0G1 .HBA WORDS .COM PR0G2 .HBA 
NAMES .TXT 


Then typing: 

>PR0G1.HBA 

ex^utes the HUffTER Basic program PR0G1.HBA. The file extension 
must be specified. To enter the Basic interpreter use the 
File Manager command 'BAS', function key 3. See Part 4, BASIC 
PROGRAMMING, for further information on HUNTER Basic. 

3.2.2 CP/M PROGRAMS 

Object code files with .COM extensions may be executed in the 
standard CP/M manner. The filename entered, for example using 
the directory above: 

>WORDS[.COM] 

will cause the program to load and run. The .COM file extension 
is optional. 


VER.V09F 


PAGE 3-3 



FILE MANAGER 


SECnON 3.3 


FILE STRUCTURE AND MEMORY ORGANISATION 


3 . 3.1 HUNTER is capable of storing a great deal of differing infor- 
mation within its large memory. There may be Basic programs, 
text files, data files or object code CP/M programs. 

Superficially the operating system handles its memory in a 
similar manner to disk backing stores, and indeed may be 
considered as a 'RAM Disk'. However HUNTER is much faster than 
any disk system and Incorporates special facilities to enable 
the memory to be efficiently utilised. 

HUNTER'S File Manager DEMOS (Disk EMulation Operating System) 
manipulates files and runs CP/M programs. The File Manager 
environment is totally unconnected with Basic. 

3.3.2 ENVIRONMENT AND STRUCTURE 

The File Manager facility is located in firmware, so there is no 
overwriting of existing programs in execution RAM. A CP/M call 
0, or a JMP 0000 both cause a "warm" start which executes the 
File Manager in ROM. This would be a typical method of ending a 
.COM program. Entering the File Manager on power up is 
equivalent to a "cold" start, in which the operating system is 
completely reset, although programs in RO are preserved. 

HUNTER'S File Manager will implement several commands and load 
and execute .COM files. Files may be erased, renamed or saved 
from memory, ASCII files may be displayed on the screen, as can 
the file directory. Finally, there is a facility for loading and 
dumping the files via the serial port in either Intel hex format 
or 8 bit binary format. 

The File Manager is structured around the CP/M compatible 
operating system and file structure. The RAM filespace, 
organised in exactly the same manner as disk based files, can 
be accessed through the system calls. Utility commands can be 
quickly selected from the soft keys. 


3 . 3.3 FILE SPACE 

Files are stored, as on magnetic disk, in records of 128 bytes 
grouped by 16's into 2K bytes. This means that the smallest 
file size is 2K bytes, but, as with magnetic media, allows for 
very large files to be stored. 

The memory space is allocated by the file manager and is 
transparent to the user. ^ ® 
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3 . 3 .^ FILE ERRORS 


3.3.5 


3.3.6 


operation is completely 
fn^rS Check when the file is Lcessed 

"no file" discrepancy Is found then a 

no iiie" message is displayed 


hunter memory ORGANISATION 


j ii/M-i liicujurjLea ana mok KUM, see 

Fig 3.1, HUNTER MEMORY MAP and Fig 3.2, HUNTER FILE ACCESS. The 
memory is organised into pages: one page of ROM operating 
execution memory and further pages of 
RAM file space. All pages except for RO, the execution memory 
(also known as the Transient Program Area, or TPA) are limited 
to 48k. RO extends to 54k, although the top 6k together with the 

^ P®8ed out. There is, therefore, up 

to 54k of RAM for programming. 


Common RAM, see Fig 3.3, SYSTEM RAM MEMORY MAP, is used to link 
together the various pages of RAM and ROM. It organises the 
paging and contains the jump tables for CP/M compatibility. The 
operation of paging is totally transparent to the user so HUNTER 
is seen to have 54k program space with a powerful 48k operating 
system and Basic interpreter in ROM, and a block of file space. 

BASIC PROGRAMMING 


Since the Basic interpreter resides in ROM, the whole 54k of RO 
is available for a Basic source program, variables and arrays. 
Simple variables are stored with the source program and Basic 
may access files for further storage. 


3 . 3.7 CP/M PROGRAMMING 

Object code programs must be executed from RO. Again, there is 
54k RAM available for the program, plus the file space. 
Normally, the program will reside in the HUNTER as a .COM file, 
and will be loaded and run by the File Manager. However, the 
File Manager is very versatile, and provides flexibility in 
file manipulation and execution. 
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3.3.8 FILE ORGANISATION 

The pages reserved for file storage have, as magnetic media, a 
"sector allocation map" and the actual directory, split into loK 
extents. Any good text on CP/M file storage will give an 
adequate explanation, which is also true for HUNTER. 

This means that 2K byte blocks of a file are in no particular 
order within the filespace RAM, making large files and fast 
updating possible. 


Fig 3.1 HUNTER MEMORY MAP 
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Fig 3.2 HUirTER FILE ACCESS 
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Fig 3.3 SYSTEM RAM MEMORY MAP 
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FILE MANAGER COMMANDS 


PROMPT 

The prompt character, which is displayed when the File Manager 
is ready to receive a command, is the greater than sign '>'. If 
this is not displayed, then no input is expected. 

3.U.2 COMMAND SYNTAX 

Commands are typed in with their arguments (usually filenames) 
separated by spaces. Wildcard characters may be specified. 
Commands may be in upper or lower case alphabetic characters. 


3.4.3 WILDCARDS 

DEMOS supports the use of wildcards '?' and ••’. The ’?' 
character will allow DEMOS to search for file names and 
disregard the characters replaced with '?' For example, suppose, 
there are five files with the names FILE1.TXT - FILE5.TXT. The 
following DIP command would only list those files; 

>DIR FILE7.TXT 

FILE1.TXT FILE2.TXT FILE3.TXT 
FILE4.TXT FILE5.TXT 

or 

>DIR A7FILE.COM 

AAFILE.COM ACFILE.COM A4FILE.COM 

The *•’ wildcard replaces the entire extension or file name. The 
example below will list all files with the extension .HBA: 

>DIR *.HBA 

PR0G1.HBA PR0G2.HBA START. HBA 
or 

>DIR MYFILE.* 

MYFILE.TXT MYFILE.COM MYFILE. HBA 

To list all the files held in HUNTER the command T)IR' is used. 
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\ 


A combination of wildcards can also be used: 

>DIR ??FILE.« 

MYFILE.TXT MYFILE.CCM MYFILE.HBA 
AAFILE.CGM ACFILE.COM A4FILE.COM 
MRFILE.HBA 

Wildcards may be used with other File Manager commands apart 
from DIR, for instance, as follows with the ERA command: 

>ERA BIG».« 

this will erase any file starting with 'BIG' and any extension 
for example, BIGER.FIL, BIG.HBA or BIGGLES.COM would all be 
deleted. 

Note that, as a precaution. Hunter will query the erasure of 
each file in turn, requiring operator confirmation at each 
stage. 
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BAS 


3. 4. 3.1 COMMAND : baS 


explanation : 

EXAMPLES : 


Execute HUNTER'S Basic interpreter. 


When the Basic interpreter has been 
following screen is displayed: 


entered the 


Hunter Basic Interpreter * • 

READY I 

I 

j 

! 

I 

File Run Edit List Save Load Kill Systi 


REMARKS 


HUM. If the last program was a CP/M program 
then an automatic NEW resets Basic, otherwise 
any Basic programs remain as before. Variables 
also remain unaffected. For complete 
programming refer to Part 

4, BASIC PROGRAMMING. 
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CLCK 


3.^i.3.2 COMMAID : CLCK 


EXPLANATION : Set the internal calendar clock to the desired 

date and time. 

EXAMPLES : Calendar clock initialisation screen: 


13 Oct 1983 11:55:00 
Time setting mode 


RDIAHKS : To set the internal calendar clock proceed as 

follows : 

a) Using the cursor right and cursor left keys, 
step the cursor to the item you wish to set. 
The seconds cannot be set and are always 
initialised to zero when synchronising the 
clock (see below). 

b) Using the cursor up and cursor down keys, 
step the value selected until it is correct. 

The months step in the following manner :- 

Nov, Dec, Jan etc. ; Cursor up 
Jan, Dec, Nov etc. ; Cursor down 

c) Set the ’minutes’ to one minute ahead of the 
present time. 

d) Press ’Enter’. HUNTER will display:- 
’Press ENTER to synchronise' 

e) When the time code, pip tone, or other 
reference arrives press ENTER. 

HUNTER'S clock will run from zero seconds in 
exact synchronisation with the external 
reference. 

f) The calendar automatically accounts for leap 
years. 
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win ^ April, HUNTER 

will display the waming:- 

Error - Incorrect day value 

before synohronl- 

Sing the clock. 

HUNTER’S clock can be used to time-stamp 
entries, automatically label printouts or even 
initiate program execution automatically like 
an alarm clock. 

details on 
functions and Section 
cans^° 3.5.3.^7 for details of CP/M clock 




FILE MANAGER 


SECTION 3.4 


COMS 


3. 4. 3. 3 COMMAND : COMS 


EXPLANATION ; Initialise the communications parameters. 


EXAMPLES : Two screens are used to select the 

communications parameters as follows: 

Transmission Parameters 
Rate-1800 Prtcl-none Pty-none 
CTS-n DTR-n LF-n Echo-n T/O-no NULL-0 
press EhTTER if acceptable 


Receiving Parameters 


Rate-1200 Prtcl-none 

Pty-none 

RTS-off DSR-n DCD-n T/O-No 

Serig-off 

press EWER if acceptable 



REMARKS : See section 6.H, COMMUNICATIONS PORT SOFTWARE, 
for Information on selecting communication 
parameters. 

NOTE: Communication parameters are not reset 
when HUNTER is powered off. 

In CP/M, the serial communications interface is 
assigned the following logical devices: 

Transmit - LST:, PUN: 

Receive - RDR: 
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CONT 


3. 4. 3.4 COMMAND 


CONT filename 


EXPLANATION : Execute program with ’continue’ option. 


EXAMPLES : >CONr PROGl.COM 


This will load and run the CP/M program 
’PR0G1.CCM’. 

The three character file type extension does not 
have to be specified for .COM files but must be 
included for HUNTER Basic files, for example, a 
HUNTER Basic program has the name ’SORT.HBA’, 
the following would load and execute the program 
via the Basic interpreter: 

X:0NT SORT.HBA 


REMARKS : If at any time during execution of a program 

initiated with ’CONT’, HUNTER is switched off or 
power down takes place, switching HUNTER on will 
cause the program to continue execution from the 
point at which power was removed. 

Escape from ’CONT’ mode during program execution 
is made by pressing ’Control C’ when power ia 
off , and then pressing ’pwr’ to power on while 
keeping ’Control C’ depressed. Two ’beeps’ 
should be heard, when the keys should be 
released. Then enter the special security 
number, the default for which is 56580. 

If an error is made, the Hunter will ’beep’ and 
return to program execution. 


VER.V09F 


PAGE 3-15 





FILE MANAGER 


SECnON 3.^ 


DIR 


3. 4. 3. 5 COMMA!® : DIR [filename] 


EXPLANATION : Display the file directory. 


EXAMPLES : >DIR 

ONEPROG.HBA TWOPROG.COM FINAL. HEX 
ANOTHER.I 

DIR can also be used with wildcards as follows: 
>DIR FILE7.TXT 

FILE1.TXT FILEP.TXT FILE3.TXT 
FILE4.TXT FILE5.TXT 


or 

X)IR A7FILE.COM 

AAFILE.COM ACFILE.COM A4FILE.COM 


or 

>DIR *.HBA 

PR0G1.HBA PR0G2.HBA START J1BA 


REMARKS : A combination of wildcard characters can also be 
used. 

If the directory is too long to fit on the 
display screen then use of the cursor control 
keys can scroll back the virtual screen to see 
the earlier entries. 

The virtual screen contains 24 lines, if a file 
directory extends to more than 24 lines, the top 
lines will scroll off the screen. Use of 
wildcards may help in limiting the number of 
directory lines displayed. 
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EDIT 


3. 4. 3.6 COMMAND : EDIT [filename] 


EXPLANATION : Edits either ASCII text or Husky Basic C.HBA) 

files. 

EXAMPLES : >EDIT PR0G1.HBA 

This will edit a Husky Basic file. 

>EDIT TEXT 

This command will edit on ASCII file TEXT.TXT. 
The .TXT is defaulted. 

>EDIT NEWS. DAY 

Edit the ASCII file of the above name. 

REMARKS : Further information on the editor can be found 

in section 7. 
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ERA 


3.4. 3.7 COMMAND : ERA filename 


EXPLANATION : Erase the specified file. 


EXAMPLES : >ERA MYFILE.HBA 

ERA may also be used with wildcards as follows: 
>ERA MY«.« 

will erase any files starting with 'MY' and any 
extension. 


REMARKS : Each filename will be displayed and the user has 

the option to enter 'Y' to delete the file or 
'N' to retain the file. If wild cards have been 
specified the next filename is displayed. Due to 
the nature of the 'RAM disk', the files can at 
no stage be recovered. 
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EXECUTE 


3. 4. 3. 8 COMMAND : EXECUTE 


EXPLANATION : Executes the current program in executable RAM 
page 0. 


examples : >EXECUTE 

>execute 


remarks : This command will normally only be used after 
LOADing a program or after using the INP 
command. However once a program has been loaded 
and if it does not alter Itself in any way, 
EXECUTE will execute it again without having to 
re-load the program. 
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3.4.3.9 COMMAM) 

: FORMAT 

EXPLANATION : 

Re-sets HUNTER'S filing system. 

EXAMPLES : 

: >F0RMAT 

FORMAT?: Are you sure (Y/N) 

REMARKS : 

When FORMAT is executed all files are deleted 
from HUNTER'S memory, leaving the user with only 
the built-in system files. This command should 
be used with caution. It is generally only 
required if a machine code program loaded into 
HUNTER has crashed causing destruction of files 
and directories. 

If 'Y' is typed in response to the above 
question the File Manager will re-set HUNTER'S 
filing system. Any files in the storage area 
will be lost. Also any programs loaded into the 
Basic workspace are deleted. 

If any other character is typed HUNTER will 
return to the File Manager. 
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3.4.3.10 


INP 


COMMAND 


INP [n filename] 


EXPLANAnON : Inputs a file via the serial port. 


example 


: INP can be used to load files in either Intel 
checksums etc., or as 8-bit 
^ checking. The second 

^tted^of loading is. towever. faster th^n us?n1 

Cl) Loading Intel Hex files 

Files to be loaded must be in Intel Hex format 
see section 9.11, HEX DATA FORMAT, irthej ar^ 
command files, overlay files or data files etc., 
achieved with a standard utiliti 
5.5, DEMONSTRATION 

Typing INP readies HUNTER to receive data, which 
dlrf!^nv"f°f'^” rff^ 5ata is not written 

“"Pleted the number 
of 56 byte blocks loaded is displayed. It may 
be copied to a file using the SAVE command.^ 
if it is a program, executed with the Execute 
command . 

(2) Loading 8-bit format. 

direcUy into a specified file in 
blMks of 256 bytes. H,e format of the command 

INP n filename 

For example a 14k overlay file: 

>INP 56 0VERLAY1.0VR 

The communications must have parity set to 8-bif 
and SERIG (Serial ignore character) set to off. 

The number of blocks must be specified because 
there is no end of file character. If too many 
blocks are expected, the screen will display 
reception may be terminated with 
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REMARKS : When HUNTER is loading data the following 
messages will appear on the screen: 

>WAinNG 

>LOADING 

>WAinNG 

>LOADING 


HUNTER responds to each pause in transmission 
with a ’WAITING' message to indicate that data 
is not being received. 

On completion of Hex loading the number of 256 
byte blod<s now in memory is displayed. 

The number of blocks, n, can be overspecified. 
For instance: 

INP 100 filename 

will load most files. Only the number of blocks 
actually required will be used following 
termination by 'ESC. 

The number of blocks is calculated by: 

1 block = 256 bytes 
IK bytes = M blocks 

NOTE: Because INP clears the receive comms 
buffer to remove spurious data when it is 
invoked, it is important to ensure that the 
HUNTER is ready to receive before the 
transmitting device begins to SEND. 
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3.^.3. 11 COMMAND 

: KEYS 

EXPLANATION 

: Operation of the 'KEYS' function displays the 
display line. Further 
f return HUNTER 

back to the original display line. 

EXAMPLES 

: SET 1 : 

DIR STAT BAS COMS CLCK TERM EDIT KEYS 
SET 2: 

DIR STAT INP SAVE TYPE REN SEND KEYS 

REMARKS 

DIR and STAT are the most commonly used keys and 
iLations^" both sets at easily accessible 

DIR - Directory 

STAT - File status 

BAS - Basic interpreter 

COMS - Corranunlcations parameters 

CLCK - Set clock 

TERM - Termiinal emulation 

EDIT - Text Editor 

INP - Load a file 

SAVE - Create a file from memory 

ITPE - Display an ASCII file 

REN - Rename a file 

SEND - Transmit files 

For further information on soft keys, see 
section ^*.5.^.1, SOFT KEYS. 
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LOAD 


3. ^.3. 12 COMMAND : LOAD filename 


EXPLANATION : The file is loaded into RAM page 0 ready for 
execution (EXECUTE) or dumping through the 
serial port in Hex format (SEND). 


EXAMPLES : >LOAD PROG1.COM 

The program PROG1.COM is loaded into the 
execution memory. 


REMARKS : Files are loaded into location 100H upwards. 

Normally, this facility will be used to dump the 
file in Intel Hex format. 
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REN 


3. 3.13 COMMAND : REN filename1=filename2 

EXPLANATION : Rename the filename2 to filenamel 

EXAMPLES : >REN NEW.NAM=OLD.NAM 

This will rename the file 0LD.NAM to NEW.NAM . 

REMARKS : Care should be exercised when renaming files 

to prevent duplicate file names existing. 
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SAVE 


3.^.3. COMMAND : SAVE n filename 

EXPLANATION : Create a file from current memory. 


EXAMPLE 


REMARKS 


>SAVE 1?a BTGFILE.COM 

This wiD create a file 32k bytes in length. 

A program currently residing from 100H in RAM 
page 0 is transferred to the specified file. 
The number of 256 byte blocks also has to be 
specified. 

Calculate the number of blocks »n' as follows: 


1 block z 

256 

bytes 

1 K bytes z 

4 

blocks 

2 K bytes = 

8 

blocks 

8 K bytes = 

32 

blocks 

16 K bytes = 

64 

blocks etc, 


The maxlmjm program size is 54K. 

See ’LOAD' in Part 5, BASIC FUNCTIONS. 
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3.4.3.15 COMMAND 

EXPLANATION 

EXAMPLES 


REMARKS 


SEND 


: SEND filename [A] 


Ojtputs files via the serial port. 


To output a file in 8-bit format: 

>SEND DEMO.COM 

To output an ASCII file to, say, a printer: 

>SEND LETTER.TXT A 

To output in Intel Hex format, first LOAD the 
file into the execution RAM page 0, then type: 

SEND n 

n is the number of 256 byte blocks required to 
be sent. 


To transmit in 8-bit format, remember to set the 
communication parameters correctly i.e. Parity 
to 8-bit and SERIG to off. 

Transmission can be aborted with the 'ESC key. 

The only real difference between 8-bit format 
and ASCII dumping is that transmissions cease on 
the first occurence of the end of file character 
'control Z' (1A Hex) in the file. 

NOTE: If transmitting, using 8-bit data format, 
a .COM or a HUNTER.HBA file, the LF option in 
the communications menu MUST be turned off to 
prevent the insertion of LF characters following 
CR characters, possibly corrupting the object 
code file being received. 

NOTE: SEND cannot transmit a file whose name 
begins with a numeric character and will return 
a Syntax error. Rename the file using REN 
first, or use Hex format. 
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STAT 


3.M.3.16 COMMAND : STAT [filename] 


EXPLANATION : Extended file directory display. 


EXAMPLES : >STAT FIRSTFIL.COM 

The following will be displayed: 


Rees Bytes Ext. ACC 
6H 16K 1 R/W :FIRSTFIL.COM 

2^K bytes available 


Rees = Number of 128 byte blocks. 

Bytes = Size of file in 'K' bytes. 

Ext = Number of 16F extension blocks. 

Acc = Access to file R/W - Read Write R/0 - 
Read Only. 


RDiARKS : STAT may also be used with wildcards. 

>STAT *.HBA 

Will display the status of all HUNTER Basic 
files stored in memory. 
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TERM 


3.4.3.18 COMMAND ; TERM 


EXPLANATION : HUfTTER emulates a CRT terminal. 


EXAMPLES : >TERM 


RQ1ARES ; In terminal emulation mode, HUNTER can be used 
as: 

1) A remote dialup terminal. 

2) A peripheral to other computer systems. 

3) A portable 'Telex'. 


See section 6.8, TERMINAL EMULAHON, for further 
information. 

Two function keys are implemented in TERM: 

Function 2 - COMMS set up 
Function 8 - Exit to system 

The type of terminal to be emulated is 
determined by the setting of the communication 
parameters. See section 6.4.1. 

NOTE: Automatic power down does not operate in 
Terminal Emulation. This prevents inadvertent 
dropping of communications lines. 

TCRM may be used from user programs (see section 

0.0. oK 
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TYPE 


3.4.3.19 COMMAND 


TfPE filename 


EXPLANATION : List ASCII file to HUNTER'S screen. 


EXAMPLES 


REMARKS 


>TYPE FILE.TXT 

This will output the filename FILE.TXT to the 
screen. 

Scrolling may be halted with 'control S' and 
restored with any other key. Any character 
typed while the screen is scrolling, besides 
'control S' will abort the display. 

Typing non-ASCII files may give confusing 
results. 
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CP/M INTERFACE 


3.5 CP/M provides a universal interface linking application programs 

into the operating system. Through a system of calls to one 
location (0005 Hex) with the CPU register C set to the call 
number, the ROM-based operating system in HUNTER will implement 
the function and return to the user program. HUNTER is there- 
fore compatible with many readily available commercial products, 
conforming to these standard system calls. 

3.5.1 SYSTEM CALLS 

CP/M system calls fall into two distinct categories. They are 
console (e.g. keyboard/LCD display) I/O and file I/O. Files are 
organised as CP/M disk files and may be accessed through a file 
control block (FCB). 

TABLE 3.2 SYSTEM CALLS 


0 System Reset 

19 Delete File 

1 Console Input 

20 Read Sequential 

2 Console Output 

21 Write Sequential 

3 Reader Input 

22 Make File 

4 Punch Output 

23 Rename File 

5 List Output 

24 Return Login Vector 

6 Direct Console I/O 

25 Return Current Disk 

7 Get I/O Byte 

26 Set DMA Address 

8 Set I/O Byte 

27 Get Addr(Alloc) 

9 Print String 

28 Write Protect Disk 

10 Read (k>nsole Buffer 

29 Get R/0 Vector 

11 Get (k)nsole status 

30 Set File Attributes 

12 Return Version Number 

31 Get Addr(Disk Parms) 

13 Reset Disk System 

32 Set /Get User Code 

14 Select Disk 

33 Read Random 

15 Open File 

34 Write Random 

16 Close File 

35 Compute File Size 

17 Search for First 

36 Set Random Record 

18 Search for Next 

37 Reset Drive 

System calls 38-4? refer 

to HUNTER operating system only. 


CP/M is a registered trademark of Digital Research Corp. 
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3.5.2 FILE COITTROL BLOCK 


'-'i iniormation on the current file 
being accessed. On HUNTER, the default FCB location is al 
005CH, containing the following Information:- 


TABLE 3.3 FCB DESCRIPTION. 


Byte Description 


1 

2-9 

10-12 

13 

14-15 

16 

17-32 

33 

34-36 


Drive code (zero) 

Eight Character ASCII filename 
ASCII file extension 
Current extent number 
Reserved 

Record count for extent 

Reserved for system use 

Current record in sequential file operation 

Random record number 


3.5.3 HUNTER SYSTEM CALLS 


This manual does not contain an exhaustive description of each 
system call, since they are defined and explained in great depth 
in many other publications. However, there does follow a brief 
description of each call, together with details of extra calls 
specific to HUfTTER. 


parameters into other registers, and the A call is made to 
address (X)05. Registers not mentioned are irrelevant on entry, 
and none are necessarily preserved on exit. For making these 
calls from Basic, see the CALL and ARG in Part 5, BASIC 
FUNCTIONS and section 4.8, MACHINE CODE CALLS. 
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3.5.3.1 

FUNCTION : 

System Reset 


CALL NO. : 

0 {ie Register C = 0 } 


ENTRY 

None 


EXIT : 

None 


REMARKS 

A system restart, re-entering HUNTER'S operating 
system. 

3.5.3.2 

FUNCTION 

: Console Input 


CALL NO. 

1 


ENTRY 

None 


EXIT : 

A=ASCII character. 


REMARKS 

Read keyboard and echo onto screen. The call will 
wait until a key is pressed. 

3.5.3.3 

FUNCTION 

: Console Output 


CALL NO. : 

2 


ENTRY : 

E=ASCII character. 


EXIT 

None 


RQ1ARKS 

The character is displayed on the screen at the 
location of the cursor. 

3.5.3.M 

FUNCTION 

: Reader Input 


CALL NO. : 

3 


ENTRY 

None 


EXIT : 

A=ASCII character. 


REMARKS 

The next character is read from the serial I/O 
buffer. 

3.S.3.5 

FUNCTION 

: Punch Output 


CALL NO. : 

4 


ENTRY ; 

E=ASCII character. 


EXIT : 

None 


REMARKS : 

The character is sent out through the serial port. 

3.5. 3.6 

FUNCTION 

: List Output 


CALL NO. : 

5 


ENTRY : 

E=ASCII character. 


EXIT : 

None 


REMARKS ; 

As call 4. 
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3.5.3.? FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 

: Direct Console I/O 
: 6 

• Character for output. 

■ A=status if out^t. 

' «ho to th^i ~ automatic 

fh K f®"’ ® Character is not ready 

from the keyboard then A=00 on return. ^ 

3. 5. 3. 8 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 

: Get I/O Byte 
: 7 
: None 

: A =1/0 status. 

: The present I/O status byte is returned. 

3. 5. 3. 9 FUNCTION 
CALL NO. : 
ENTRY : 

EXIT 

REMARKS : 

: Set I/O Byte 
8 

E=I/0 value. 
None 

I/O byte is set. 

3.5.3.10 FUNCTION 
CALL NO. : 
ENTRY : 

EXIT 

REMARKS : 

: Print String to Console 
9 

DE=string address. 

None 

DF start address is leaded into 

UmlnatTwTh 

3.5.3.11 FUNCTION : 
CALL NO. : 
ENTRY : 

EXIT : 

REMARKS ; 

Read Console Buffer 
10 

DE=buffer address. 

None 

The keyboard is read and the characters are placed 
t nf address having been loaded 

nulLr nr 1 contains the maximum 

number of characters to read into the buffer the 
second byte contains the number of characters ’ that 
hfTn placed into the buffer when input has 

been terminated with C/R or L/F. See section 9.15, 
read console buffer, for further information. 
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3.5.3.12 FUNCTION 

; Get Console Status 


CALL NO. 

: 11 


ENTRY 

: None 


EXIT 

: A=console status. 


REMARKS 

: If a character has been typed In then 01 H is 
returned, OOH if not. 

3.5.3.13 

FUNCTION 

: Return Version Number 


CALL NO. 

: 12 


ENTRY 

: None 


EXIT 

: HL=version number. 


REMARKS 

: HUNTER is CP/M version 2.2 compatible, so 0022H is 
returned. 

3.5.3. 1^ 

FUNCTION : 

: Reset Disk System 


CALL NO. 

! 13 


ENTRY 

: None 


EXIT 

; None 


REMARKS 

: The filing system is reset, and the DMA address is 

returned to 80H. 

3.5.3.15 

FUNCTION : 

Select Disk 


CALL NO. : 



ENTRY 

None 


EXIT 

None 


REMARKS 

HUNTER has "RAM disks" so this call produces no 
action. 

3.5.3.16 

FUNCTION : 

C^en File 


CALL NO. 

15 


ENTRY 

DE=FCB address. 


EXIT 

Ardirectory code 


REMARKS : 

The file specified by the FCB is opened. If 
successful A=0,1,2 or 3. If not, then A=0FFH. 

3.5.3.17 

FUNCTION : 

Close File 


CALL NO. 

16 


ENTRY 

DE=FCB address. 


EXIT 

A=dlrectory code. 


REMARKS 

3. otherwise 


VER.V09F 


PAGE 3-36 


FILE MANAGER 


SECTION 3.5 


3.5.3.18 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 

Search for First 
17 

DE=FCB address. 

Ardirectory code. 

The directory is searched for the first match of 
the FCB. ArOFFH if there is no match, and 0,1,2 or 
3 if there is. The filename is returned into the 
current DMA buffer. The search function returns 
the complete entry from the buffer. 

3.5.3.19 FUNCTION : 
CALL NO. : 
ENTRY 
EXIT 
REMARKS 

: Search for Next 

; 18 
: None 

Ardirectory code. 

: Similar to CALL 17, except that the next entry is 

looked for. The search function returns the 
complete entry from the buffer. 

3.5.3.20 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 

Delete file 
19 

DErFCB address. 

Ardirectory code. 

Files which match the FCB are deleted. If none 
exist ArOFFH is returned. 

3.5.3.21 FUNCTION : 
CALL NO. : 
ENTRY 
EXIT 
REMARKS 

Read Sequential 
20 

DErFCB address. 

Ardirectory code. 

The specified file is read, and the sector copied 
to the current DMA address. A r 00 for a successful 
read. 

3.5.3.22 FUNCTION : 
CALL NO. : 
ENTRY : 

EXIT : 

REMARKS : 

Write Sequential 
21 

DErFCB address. 

Ardirectory code. 

The record at the current DMA address is written to 
the disk. ArOO to indicate a successful write. 

3.5.3.23 FUNCTION : 
CALL NO. : 
ENTRY : 

EXIT : 

REMARKS : 

Make File 
22 

DErFCB address. 

Ardirectory code. 

The specified file is created. ArO-3 if successful, 
or ArOFFH if not. 
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3.5.3.24 FUNCTION 
CALL NO. 
EITTRY 
EXIT 
REMARKS 

: Rename a File 
: 23 

: DErFCB address. 

: A=dlrectory code. 

: The file specified in the first 16 bytes of the FCB 

is renamed to that name in the second 16 bytes. 

3.5.3.25 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 

: Return Login Vector 
; 24 

: None 

: HLrlogin vector. 

: HUNTFR returns HL=1 and A=1, indicating a single 

disk system. 

3.5.3.26 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 

: Return Current Disk 
: 25 
: None 

: A=current disk. 

: Zero is always returned on HUNTER. 

3.5.3.27 FUNCTION ; 

CALL NO. : 
ENTRY 
EXIT 
REMARKS 

: Set DMA Address 
: 26 

DE=DMA address. 

: None 

The current disk data buffer area is set to DE. 

3.5.3.28 FUNCTION : 
CALL NO. : 
ENTRY 

EXIT : 

REMARKS : 

Get Allocation Address 

27 

None 

HL=allocation address. 
Zero only is returned. 

3.5.3.29 FUNCTION : 
CALL NO. : 
ENTRY ; 

EXIT 

Write Protect Disk 
28 

REMARKS 

Returns with no effect. 

3.5.3.30 FUNCTION : 
CALL NO. : 
ENTRY 
EXIT 

Get Read Only Vector 
29 

remarks 

Returns with no effect. 
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3.5.3.31 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 

• 30^ Attributes 

• DE=FCB address. 

I A=di rectory code. 

' --“'t 

3.5.3.32 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 

: ^t Disk Parameter Address 
: None 

: HL=disk parameter block address 

* are returned which indicate a 

double sid^ double density disk. This is to allow 

rZ ”^thin HUfTTER. it should not be us^ 

for space calculation purposes. 

3.5.3.33 FUNCTION : 
CALL NO. : 
ENTRY 
EXIT 

: Get or Set User Code 
: 32 

REMARKS 

Returns with no effect. 

3.5.3.34 FUNCTION : 
CALL NO. : 
ENTRY 

EXIT : 

REMARKS : 

Read Random 
33 

DE=FCB address 
A=directory code. 

The file is read at the specified record. Normally 
non zero directory codes mean an error. 

3.5.3.35 FUNCTION : 
CALL NO. : 
ENTRY 

EXIT : 

REMARKS : 

Write Random 
34 

DE=FCB address. 

Asdirectory code. 

The file is written at the specified record. A-0 
means a successful write. '^uro. «.u 

3.5.3.36 FUNCTION : 
CALL NO. ; 
ENTRY : 

EXIT ; 

REMARKS ; 

Compute File Size 
35 

DE=FCB address 
r«ord” 
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3.5.3.37 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 

: Set Random Record 
: 36 

: DE=FCB address. 

: Random record field set. 

3.5.3.38 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 

: Reset Drive 

: 37 

: DE=drive vector. 

: None 

: HUNTER'S filing system is reset. 

3.5.3.39 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 

: Set up the RS-232 Serial Port 

: 38 

: None 
: None 

; The software setup routine is entered to set up the 
serial communications. 

3.5.3.40 FUNCTION 

CALL NO. : 
ENTRY 
EXIT 
REMARKS 

: Initialise the Clock 

: 39 
: None 

: None 

; and date buffer RAM la copied to the 

3.5.3.41 FUNCTION ; 

CALL NO. : 
ENTRY : 

EXIT 
REMARKS 

Write Random with zero fill 
40 

DE=FCB address 
A = directory code 

IJ^lK Sl”o„1ir w7[h°/ht“ c°eSThV: 

be^oTdlLTs^Ittel 

?l“?^Jre'’n"tTriLrn!'"^"“- « 

3.5.3.42 FUNCTION : 
CALL NO. : 
ENTRY 

EXIT : 

REMARKS : 

Initialise communications 

None 

None 

This call allows conf iaurat i r»n ti. 

exactly as the standard HUNTER 
initialise communications routine. 
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3 . 5 . 3.43 FUNCTION 
CALL NO. 

ejttry 

EXIT 

REMARKS 

: Serial Status 

: 42 

: None 

: A = port status 

* no pending serial input characters A=0 for 

no characters read else A is non-zero 

3 . 5 . 3.44 FUNCnON 
CALL NO. 
EirrRY 
EXIT 
REMARKS 

: TYminal emulation call 

: None 
: None 

: Enters terminal enulation mode 

3 . 5 . 3.45 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 

: Wand input call 
: 44 

: DE=Buffer Address 
: None 

: The Wand code is selected previously by setting the 
bartype location according to wand code being read. 

The code is read into the buffer. The user must 
provide the buffer address and, in the first 
location of the buffer, the user must provide the 
maximum number of characters to be read into the 
buffer. On exit, the second byte of the buffer 
contains the number of characters that have been 
placed in the buffer, followed by the wand 
character's input. 

3.5.3.46 FUNCTION : 
CALL NO. : 
EITTRY 

EXIT : 

REMARKS : 

Fetch key without echo 

47 

None 

A = ASC code of character 

3 . 5 . 3.47 FUNCTION : 
CALL NO. : 
ENTRY : 

EXIT 

REMARKS : 

Read the Clock 
48 

None 

None 

The time and date is copied from the clock into the 
time and date buffer RAM (see section Q 7) 
locations TENTHSEC to TENYR. * ’ 
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3.6 


LOADING FILES 


The most important facility of a portable computer is its 
ability to communicate with other computers and oeripheral 
devices. HUNTER has an industry standard RS-232 interface, 
supporting the most common and some of the not so common 
protocols and baud rates. See Part 6, COMMUNICATIONS. 


HUNTER is supported by a wide range of micro computer systems 
including the IBM-PC, Superbrain, Apple (with Z80 card) and ACT- 
Sirius. Sections 3.6.i| and 3.6.5, give a detailed description 
of how to connect the Apple and IBM-PC micro computers to HUNTER 
and transfer files. 


me a„“ASCirt«\'fUe“ 

Two mettods of loading files are described. The first Involves 
out^ ^ format. Files are sent 

f Utility is used it must have the [ 0 ] 

mpFh^ indicate that all 8 bits must be sent. The second 
consuming, but has the advantage of built in 
checksums to guarantee the accuracy of data. All files 
including ASCII data files, must be converted into Intei He)! 

oe riPed out to HUNTER in the normal manner. Both methods are 
described in full detail In the following subsectlonl ?Se 
examples are particular to a CP/M machine. 

NOTE: Some CP/M systems may not be configured for 8 

d%7aufor4e'’-UAB?"'“"r/''* '’ardSa^'^/anua? “r" 

Details of the UART configuration if in doubt. 
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.6.1 FILE DESCRIPTION 


File Name 

Type 

Length (k) 

No. blocks No. records 
(4xlength) (8xlength) 

MAIN.COM 

Object 

22k 

88 

176 

OVERUY.OVR 

Object 

10k 

40 

80 

PRODUCTS.TXT 

ASCII 

14k 

56 

112 


The program MAIN.COM is a fictional file which organises and 
sorts a database file PRODUCTS.TXT . The file 0VERLAY.0VR is an 
overlay file which like MAIN.COM is an executable program, but 
parts are loaded into the execution RAM page as and when 
required by MAIN.COM. All three files must be present in the 
filespace for correct operation. 


3.6.2 LOADING METHOD 1: 8-BIT DATA 

Step 1 Set up the communications, see Part 6, COMMUNICATIONS. 

Baud rate : As required. 

Protocols : None. 

Parity : 8-bit. 

RTS : As required. 

SERIG : Off. 

Step 2 Determine the size of the files to be copied. 

A>STAT «.» 


Rees 

Bytes 

Ext 

Acc 


176 

22k 

2 

R/W 

A:MAIN.C0M 

80 

10k 

1 

R/W 

A : OVERLAY .OVR 

112 

14k 

1 

R/W 

A: PRODUCTS. TXT 


HUNTER loads files in blocks which are each twice the 
size of Records. Therefore MAIN.COM is 88 blocks in 
length. 

Step 3 Load MAIN.COM 

Connect up HUNTER to the host computer with a suitable 5 
way RS-232 cable. Then on HUNTER type: 

>INP 88 MAIN.COM 
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After typing E^^'ER, HUNTER will respond with 
• Waiting 

To abort use the ESC key. If PIP is to be used to 
transfer the file to HUNTER using the LST; printer 
port, then type on the host computer 

PIP LST: rMAIN.COM [0] 

The [ 0 ] suffix is very important because this tells PIP 
to list using the full 8 bits. HUNTER will respond to the 
beginning of transmission with the message 

» Loading 

If too many blocks have been specified in the INP command 
then after transmission has completed the ’waiting' 
message will again be displayed. In this case use the ESC 
key to complete the transference of the file. 

The file MAIN.COM will now reside in a HUNTER file. 

Step H Load OVRERLAY.OVR 

The sequence of commands for loading this file is as 
follows: 

HUNTER >INP 40 OVERUY.OVR 

Host PIP LST:=OVERLAY.0VR[0] 

5 Load PRODUCTS.TXT 

This file is loaded with these commands: 

HUNTER >INP 56 PRODUCTS.TXT 

Host PIP LST:rPR0DUCTS.0VR[0] 

6 Run the program 

The three files MAIN.COM, MAIN.OVR and PRODUCTS.TXT 
should all now be in HUNTER files. Check this with the 
DIR command. Execute the CP/M program with 

>MAIN 

NOTE: Some CP/M machines may not be capable of 
transmitting 8 bits per byte. 
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3.6.3 U)ADING HETOD 2: imn. HEX DATA FORMAT 


JusuJly^calle7mw^',^ standard CP/M utility* program 
in r.'’u*N^S’AD°‘; 


When converted you will have two 
in Intel Hex format: 


copies of each file, one 


MAIN.COM 
OVERLAY .OVR 
PRODUCTS.TXT 


MAIN. HEX 
OVERLAY. HEX 
PRODUCTS. HEX 


step 2 Set up the cororounloatlons, see Part 6, COMMUNICATIONS. 


Baud rate 

Protocol 

Parity 


RTS 

SERIG 


: As required 
: NONE 

: As required 
: As required 
: OFF 


Step 3 Load MAIN.COM 


way no-rot: caoie. inen on HUNTER type: 


a suitable 5 


>INP 


After typing ENTER, HUNTER responds with 
* Waiting 


To abort use the ESC key. If Pip is to 
transfer the file to HUNTER using the LST: 
port, then type on the host computer 


be used to 
printer 


PIP LST:=MAIN.HEX 


As soon as transmission begins, HUNTER responds with 
* Loading 


VER.V09F 


PAGE 3-45 


FILE MANAGER 


SECTION 3.6 


The file is loaded not directly into a file, but to RAM 
page 0, the program execution page. When the file is 
loaded and HUNTER displays 

• Loading completed 
File length = 88 Blocks 

the data is written into a file with the SAVE command. In 
this case. 

>SAVE 88 MAIN.COM 

The file MAIN.COM is now created. 

Step 4 Load OVERUY.OVR 

The sequence of commands for loading this file is as 
follows: 

HUNTER >INP 

Host PIP LST:=OVERl.AY.HEX 

HUNTER >SAVE MO 0VERLAY.0VR 

Step 5 Load PRODXTS.TXT 

This file is loaded with these commands: 

HUNTER >INP 

Host PIP L5T:= PRODUCTS J1EX 

HUNTER >SAVE 56 PRODUCTS.TXT 


St^ 6 Run the program 

The three files MAIN.COM, MAIN.OVR and PRODUCTS.TXT 
should all now be in HUNTER files. Check this with the 
DIR command. Execute the CP/M program with 

>MAIN 
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N^: This method of loading HUNTER is again suitable for 
all types of files, but compared with 8-bit loading is 
^ slower. However it does have the 

fhan error occures during transmission 

then the hex checksum will detect this and 

* Loading error 

will be displayed. 


3.6.4 HUIfTER TO APPLE INTERFACE 

computer fitted with a Z80 card and running 
” 0 P®*"ating system can communicate with HUNTER via the 
RS-232 communications port. 

When the HUNTER is downloading to the Apple, problems may arise 
if the file being transferred is larger than 16K. This is 
because the Apple does not prevent incoming data during a disk 
access, and therefore may well loose characters. It is 
^ arrange for data within the HUNTER to be stored in 
ibK files and then transmit each file separately. 

3.6.4. 1 Apple Serial Card 


A standard Apple compatible serial interface card, preferred 
type CCS7710A, must be installed in slot 2 of the Apple with its 
25 pin 'D‘ connector mounted on the rear panel in position 7. 

3. 6. 4. 2 Interface Cable 


The interface cable required to connect HUNTER to an Apple micro 
computer fitted with the above serial card should be fitted with 
a female 25 pin 'D' connector at one end, HUNTER, and a male 25 
pin 'D* connector at the other, Apple. Pins 2,3, 4, 5 and 7 should 
be connected with a jumper connection from pin 8 to pin 20 on 
the male connector, Apple, see Fig 3.4, HUNTER TO APPLE CABLE. 
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Fig 3.4 HUNTER TO APPLE CABLE 


HUNTER APPLE 



o ' 







RED 



* •. 


BLUE 


* •• 


WHITE 




YELLOW 




BLACK 

ii „ •* 

• A 



«* 

o 

V 

Female 25 way 

D-Type 

(25S) 


Male 25 way 
D-Type 
- I25P) 


3. 6. 4. 3 Apple Baud Rates 

The baud rate on the Apple is selected by setting the 4-way DIP 
switch located at the top right hand comer of the above serial 
interface card, the switch should be set to 4800 baud, see Fig 
3.5, APPLE BAUD RATE SELECTION, for switch setting's. 
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Fig 3.5 APPLE BAUD RATE SELECTION 



3. 6. 4. 4 HUNTER Baud Rate and Protocols 


HUNTER'S communication parameters should be set as follows: 


Transmit 

Rate-4800 

Prtcl-N 

Prty-N 

CTS-Y 

DTR-N 

LF-Y 

Echo-Y 

Null-0 


Receive 

Rate-4800 

Prtcl-N 

Prty-N 

RTS-HOLD 

DSR-N 

DCD-N 

Serig-off 


VER.V09F 


See section 6.4, COMMUNICATIONS PORT SOFTWARE, for further 
details of selecting and setting HUNTER'S communication 
protocols. 
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3. 6. 4. 5 Basic Program Transfer 

When the correct communication protocols have been set and the 
interface cable installed, program transfer can take place. 
HUNTER will be treated as RDR; for input and PUN: for output. 
HUNTER should be in Basic interpreter mode, select 'BAS' from 
the File Manager function keys, with the program resident in 
RAM page 0, for Basic text transfers. For file or CP/M program 
transfers, refer to the examples given earlier. 

HUNTER to Apple 

To transfer a program from HUNTFR to the Apple proceed as 
follows: 

1) Apple >PIP A:filename=RDR: 

2) HUNTER LUST 

3) When transmission is complete type L0PCHR26 (control Z) on 
HUhfTFR. 

4) Apple will now have a copy of the program stored on disk with 
the specified filename. 

NOTE: If the program is greater then 20k the Apple may store 
part of the file to make more memory available for the incoming 
program. 

Files created on the Apple in this way can be handled with the 
usual CP/M utilities such as 'ED' or more sophisticated programs 
such as word processors etc. 

Apple to HUNTER 

To transfer a program from an Apple disk file to HUNTER proceed 
as follows: 

1) Clear HUNTER'S memory with 'NEW'. 

2) HUNTER LLOAD 

3) Apple >PIP PUN :=A: filename [E] 

4) When transmission is complete switch HUNTER off and back on 
again, the program may now be run. 

3.6.5 Hunter to IBM-PC Interface 

An IBM PC or XT computer, fitted with the asynchronous 
communications adaptor can communicate with the HUNTER to either 
load or unload programs and data. 
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From the filemanager; 

(i) INP 

(ii) SEND 

and the following HUNTER BASIC commands/statements: 

(i) LLOAD 

(ii) LUST 
(lii) UNPUT 

(iv) LPRI NT 

(v) UNCHR 

(vi) LOPCHR 

See also the section on Communications, Section 6, with 
particular attention to comms parameter setup. 

b) The IBM-PC 

Special software is required for full communication capabilities 
on the IBM-PC. This software, together with the interface 
cable, is available from Husky Computers Limited on an IBM disk. 


3.6.5.^ HUNTER (kwnunications Set-up 

To communicate in both directions at ^800 baud, the 
communication parameters should be set as follows: 


TRANSMIT 

RECEIVE 

Rate - 4800 

Rate - 4800 

Prtcl - None 

Prtcl - None 

Prty - 8-bit 

Prty - 8-bit 

CTS - y 

RTS - hold 

DTR - n 

DSR - n 

ECHO - n 

DCD - n 

LF - n 

Serig - Off 

Null - 0 
T/0 - no 

T/0 - no 


The above setup allows full bi-directional communications with 
hardware handshaking. Both ASCII text files and 8-bit object 
code files can be up and down loaded. 
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3. 6. 5. 5 IBM-PC Coonunlcations Program 

The files supplied on disk are: 

CCMMS1 .BAS 

BASIC.COM 

HUNTCOM.BAT 

To run the program, follow these steps: 

a) Ibrn on the IBM-PC 

b) Insert a ’DOS’ disk into the A drive 

c) Insert the supplied disk into the B drive 

d) Copy the files onto the A disk: 

copy B:».» A: 

e) Remove the B disk and store in a safe place 

f) Type: 

huntcom 

g) The IBM comms program is now running and asking for your 
selection of baud rate. 

It displays: 

Asynchronous Communications Program 
select baud rate (’s’ for system): 

(1) 300 

(2) 1200 

(3) ^800 

3. 6. 5. 6 Loading files from the IBM-PC 

Make sure the file you want to send is on one of the disks in 
the IBM-PC and also that the three communications files are on 
the disk in the A slot. 

a) Plug the cable into the HUNTER and into the asynchronous 
port. 

b) Switch on the HUNTER and enter the file manager. 

c) Set up the HUNTER comms parameters. 

d) On the HUNTER, type: 

INP no. blocks filename 
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The number of blocks (256 bytes) may be greater than the actual 
number, but never less. 

e) On the IBM-PC, select the baud rate: 

l.e. type '3' for ^800 baud 

f) You are now prompted with: 

(R)receive or (T)ransmit _ 

Type 't' for transmit. 

g) Enter the filename of the file you wish to transfer. It may 
be preceded with a drive name if required: 

e.g. b: filename 

h) The bottom line of the display should sJ»w: 

transmitting 

to indicate that transmission is taking place. 

When the file has been sent, the comms program will return to 
the baud rate set-up. If no more communications are required, 
type 's' for system. 

NOTE: If the message 'waiting to transmit' is displayed, then 
the HUhTTER is not ready to receive the file. 

3. 6.5.7 Sending files to the IBM-PC 

Ensure that the 3 communications files are on the A disk in the 
IBM. 


a) Plug the cable into the IBM and the HUNTER and switch on the 
HUhTTER. 

b) It is Important to ensure that the RS-232 interface is 
powered up on the HUNTER before transmission occurs - to 
avoid an extraneous character on power up wich would 
otherwise be added to your file. Power up the interface by 
selecting TERMINAL mode then return to the filemanager. 

This procedure only has to be followed when the HUNTER is 
first powered up. 

c) Set up the HUNTER corrms parameters as before. 
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d) On the IBM, select baud rate. 

i.e. type '3' for 4800 baud. 

e) When prompted with: 

(R)eceive or (T)ransmit _ 

type 'r' for receive. The following message will then 
appear on the bottom line. 

'any key to abort' 

f) On the HUNTER, type: 

SEND filename 

where filename is the name of the file you wish to transmit. 

g) When transmission is over, the HUNTER displays the message: 

'COMPLETED' 

h) Hit any key on the IBM to close the received file and return 
to the beginning of the program. 

3. 6. 5. 8 Communicating HUNTER Basic programs 

A HUNTER Basic program (.HBA suffix) is stored in a tokenised 
form. These may be transferred to and from the IBM-PC, as 
described above. 

A HUNTER Basic program, when stored on the IBM, is not in ASCII 
text form and cannot, therefore, be listed or displayed. 

If it is desired to transfer the ASCII text of a program, it is 
necessary to transmit the program from the HUNTER Basic 
Interpreter as follows: 

a) Plug the cable into the IBM and the HUNTER and switch on the 
HUNTER. 

b) It Is important to ensure that the RS-232 interface is 
powered up on the HUNTER before transmission occurs - to 
avoid an extraneous character on power up wich would 
otherwise be added to your file. Power up the interface by 
selecting TERMINAL mode then return to the filemanager. 
This procedure only has to be followed when the HUNTER is 
first powered up. 
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c) Set up the HUNTER conins parameters as before. 

d) On the IBM, select baud rate. 

l.e. type '3' for ^<800 baud. 

e) When prompted with: 

(R)ecelve or (T)ransmit _ 

type 'r' for receive. The following message will then 
appear on the bottom line. 

'any key to abort' 

f) Enter Basic on the HUNTER with the Basic file loaded into 
the workspace. On the HUNTER type: 

LLIST 

This will list the Basic program to the IBM for storage in 
the selected file. 

g) Transmission is over when the HUNTER displays: 

READY 

h) Hit any key on the IBM to close its file. 

An ASCII file with Basic Text may be transferred directly into 
the Basic workspace using the LLOAD command in Basic. This is 
done as follows: 

a) Plug the cable into the HUNTER and into the asynchronous 
port. 

b) Switch on the HUNTER and enter the file nanager. 

c) Set up the HUNTER conms parameters. 

d) On the HUNTER enter Basic and type: 

LLOAD 

e) On the IBM-PC, select the baud rate: 

i.e. type '3' for ^<800 baud 

f) You are now prompted with: 

(R)receive or (T)ransmit _ 

Type 't' for transmit. 
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g) Enter the filename of the file you wish to transfer. It may 
be preceded with a drive name if required: 

e.g. b: filename 

h) The bottom line of the display should show: 

transmitting 

to indicate that transmission is taking place. 
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MEMORY MAPS 


3.7 This section describes the operating system RAM at the top of 

page RO, Important locations are detailed, many of which the 
user may wish to use for advanced programming. Fig 3.6, RAM PAGE 
0, is an overall map of the system. A listing of memory 
locations may be found in section 9.7, MEMORY LOCATIONS. 


Fig 3.6 RAM PAGE 0 



FFFF 


F841 


F780 

F660 

F400 

F200 

FOOO 


EOOO 

DF80 


0800 


0700 
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AUTO RUN 


3.8.1 INTRODUCTION 

The automatic program continuation command ’CONT' provides the 
user with the facility to continue execution of a program after 
HUNTER has been switched off. Power off may have been caused by 
execution of the POWER OFF function in Basic, Auto power off or 
operation of the power off key. 


3.8.2 COfWAMD SYNTAX 

The syntax of the 'CONT* command is as follows: 

>CONT filename 

where 'filename' is the name of a file containing a Basic source 
program or a CP/M program. The three character file type 
extension does not have to be entered if it is a .COM file, but 
must be included for HUNTER Basic files. For example, if a Basic 
program file is called PR0G1.HBA, the following command would 
load and run the program via the Basic interpreter: 

>C0^^• PR0G1.HBA 

and the CP/M program PROGA.COM would be run if the following was 
entered: 

>CONT PROGA 

If the filename does not have a .COM or .HBA extension, 'CONT' 
will default the file type extension to .COM, so if the filename 
PR0G2.TXT is entered 'CONT' will default the filename to 
PROG2.COM. If it does not exist a 'File not found' error will 
occur. 


3 . 8.3 PRXRAM CONTINUATION 

At any time during program execution HUNTER may be switched off 
by operation of the power key, automatic power off or any other 
means *. The next time HUNTER is switched on the program will 
continue execution from the point at which HUNTER was switched 
off. 


» See 3.8.5. 
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3.8.4 EXITING 'coirr' 

To escape from 'CONT' press (control C) and hold down, then 
power up. HUNTER will bleep twice and then wait for the escape 
code to be entered (default code 56580). Failure to enter the 
correct code will result in a bleep from HUNTER and continuation 
of the program. If the code is entered correctly then HUNTER 
will power down immediately. The next power up will revert to 
the operating system in the normal way. When continuing a .HBA 
file it is possible to escape from the program by pressing 'ESC 
and entering the escape code as above. 

3.8.5 POWER LOSS 

If power loss occurs by removing the batteries, the next power 
up will cause HUNTER to reload the file that was being run and 
execute the program from the start. 

Power loss can also be caused by excessive shock, battery 
failure, nuclear effects or other means. 
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3.9 DEMOS ERROR MESSAGES 

The following are operating system error messages which can occur in 
DEMOS; 

3.9.1 Syntax 
Due to:- 

a) Missing '=' between 2 filenames in REN 

b) Missing nuntoer of 128 byte blocks in SAVE 

c) Missing space between byte block number and name in SAVE 

d) Missing number of 128 byte blocks in INP 

e) Missing space between byte block number and name in INP 

f) Missing number of 256 byte blocks in SEND 

g) Missing CR immediately after the filename in SEND 

3.9.2 No File 
Due to:- 

a) Missing file name in EDIT 

b) The file does not exist in ERA 

c) The old file name does not exist in REN 

d) The Basic file does not exist when trying to load and run the 
file from DEMOS 

e) No files in the HUNTER when enter STAT ».» 

f) .COM file does not exist when name is entered 

3.9.3 Bad Name 


Whenever an invalid file name format is specified. 

3.9.4 Memory Overflow 


Due to:- 

a) The text equivalent of a basic tokenised file exceeding the 
available space in Ram page 0. 

b) Excess number of 128 byte blocks in SAVE 

c) Excess number of 256 byte blocks in SEND 
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3.9.5 Aborted 
Due to:- 

Pressing the ESC key when the HUNTER is executing TYPE or INP 

3.9.6 Disk Full 

At any time when trying to write to a file when there is no space 
remaining in the file space. 

3.9.7 Disk Error 

Due to a file having been corrupted, e.g. an incorrect checksum for 
the file. 
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4.1 


4.1.1 


INTRODUCTION 


insLaiiea within HUNTER’S firmware, allowing user programs to be 
easily written and used without the need for any additional 
equipment. In addition to normal programming features, HUNTER 
Basic can also handle communications with other devices. 


^ designed for use in the portable environment, 
HUNTER Basic has some unique features not found in other 
Basics. Principal among these is the ability of HUNTER Basic to 
keep both programs and data after its power has been switched 
off. Data can be used later by the same or another program 
following an intervening period when HUNTER is powered down and 
not in use at all. Similarly, user programs written in HUNTER 
Basic are retained and are always available for further use 
until deliberately cleared. 

Different programs can be stored simultaneously in program space 
or in files and executed independently. 

INITIATING HUNTER BASIC 

HUNTER Basic is accessed from the File Manager by typing BAS 
followed by the 'Enter' key or by pressing the appropriate 
function key if the HUNTER System Functions are displayed. When 
HUNTER'S Basic Interpreter has been entered the following screen 
is displayed: 


Hunter Basic Interpreter | 

READY I 

I 

I 

I 

I 

I 

File Run Edit List Save Load Kill Syst | 


To return to File Manager from Basic press 'SYST' function key 
or type 'SYSTEM' and press the 'Enter' key. 

Alternatively, a HUNTER Basic program (.HBA extension) may be 
executed directly from the File Manager by typing the file name 
followed by 'Enter'. In this case, the Basic Interpreter screen 
does not appear and the program executes immediately. For 
further details see section 3.2, PROGRAM EXECUHON. 
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4.1.2 BASIC PROGRAMS 

Program source code for execution by the resident Basic 
Interpreter can be provided by a variety of sources, including 
the following: 

1) HUNTER Basic (.HBA extension) files. 

2) Text (.TXT extension) files. 

3) Direct keyboard entry using Edit. 

4) Down line loading using LLOAD. 

Programs are entered into HUNTER'S execution memory by a 
sequence of line numbers and program statements. Unnumbered 
lines will execute immediately. Variables can always be 
inspected using "Print" statements. Effects of functions and 
other operators can be determined empirically by simply typing 
unnumbered lines and observing the result. 

Certain functions cannot be executed directly 
e.g. GOSUB 

NOTE: It is recommended that NEW is typed before entering a 
program in order to remove any previous programs. 

4.1.3 AUTO START BASIC 

Provision has been made for Basic programs to execute 
immediately on power up. See section 4.12, AUTO POWER FEATURE. 

NOTE: A number of programs can be found in section 9.5, 
DEMONSTRAHON PROGRAMS. 


[r 

L 
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SYNTAX 


4.2 The functions described in this manual follow the conventions 

set out below. For all Basic statements and commands the syntax 
must be correct for the program to run successfully. 

1 ) Basic reserved words are printed in uppercase, but they may 
be entered into HUNTER as either uppercase or lowercase or a 
combination of both. Either way, the interpreter will 
convert them to uppercase. 

2) Items not in square brackets are essential arguments to the 
Basic function and must be included. 

3) Square brackets indicate that the item is optional. 

4) Punctuation must be included where shown. 

4.2.1 DESCRIPTION OF FUNCTIONS 

HUNTER Basic understands four kinds of function; 

Commands 

Statements 

Operators 

Functions 

Commands generally initiate an action and can also control 
execution of application programs. 

Statements form the structure of application programs and direct 
program flow. 

Operators are used to relate data and to test for specified 
conditions. 

Functions perform arithmetic or string computations. 

Some commands and statements will function without further 
information, others require an argument. An argument is either a 
value, an expression or another function. 

A complete list of functions is given in section 5.1, INDEX TO 
BASIC FUNCTIONS. 
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4.2.2 EXPRESSIONS AND OPERATORS 


TABLE 4.1 SYMBOLIC OPERATORS FOR USE WITH NUMERICAL VARIABLES. 


= Equality or assignment of values 
+ Addition 

Subtraction or negation of value 
• Multiplication 

* or ** Powers 
/ Division 

( Open parenthesis 

) Closed parenthesis 
=> Equal to or greater than 
=< Equal to or less than 

< Less than 

> Greater than 

<> Not equal to 
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TABLE 4.3 LOGICAL OPERATORS 


Logical operators perform logical or 
Boolean operations on numeric values: 


NOT logical complement 
AND conjunction 
OR disjunction 
XOR exclusive OR 
EQV equivalence 
IMP implication 


TABLE 4.4 TRUTH TABLES 


NOT X NOT X 

T F 

F T 


AND X y X AND Y 

T T T 

T F F 

FT F 

F F F 


OR X y X OR Y 


T T T 

T F T 

FT T 

F F F 
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TABLE A. A CCUfT. 


XOR 

X 

Y 

X XOR Y 


T 

T 

F 


T 

F 

T 


F 

T 

T 


F 

F 

F 

EQV 

X 

Y 

X EQV Y 


T 

T 

T 


T 

F 

F 


F 

T 

F 


F 

F 

T 

IMP 

X 

Y 

X IMP Y 


T 

T 

T 


T 

F 

F 


F 

T 

T 


F 

F 

T 


4.2.3 LOGICAL OPERATIONS 

Logical operators act upon the binary equivalents of decimal 
arguments, bit by bit, where the argument is a 16 bit signed 2*s 
complement number i.e. in the range -32768 to +32767. For 
example: 

PRIOT 10 AND 6 

will print 2, since: 

10 = 0000000000001010 
6 = 0000000000000110 

Performing the AND operation bit by bit, only one bit remains 
non zero. See the AND truth table in TABLE 4.4 TRUTH TABLES for 
further details. 
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J 


Logical operations 
for example: 


may also be used by conditional statements. 


IF A=B AND B=C THEN PRIhrr”ALL EQUAL” 


In this example the following occurs: 


tnen a true (-1) condition is returned, 
is returned. 


If not then a false (0) 


® in^oratove? ’'''’e results are 


u; and (2) above, which returns either a true (-1) or false (0) 
^erfoV. this final result upon which the irsmement 

^ conditional test (true or false). Since 
statements always produce a logical result it is 
possible in some circumstances to omit a relational operator. 
I or example: ’ 


IF A<>0 THEN PRINP'A IS NON ZERO” 
may be replaced with: 


IF A THEN PRIfn*”A IS NON ZERO” 


or 


IF A=5 THEN PRIITT -1 ELSE PRIfH’ 0 
may be replaced with: 

PRINT A=5 

since A and 5 are tested for equality and if they are equal the 
-1 (true) is printed otherwise 0 (false) is printed. 
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VARIABLES 


4.3 The Basic workspace execution memory is automatically 

partitioned by the interpreter according to the number of 
program lines entered by the user and the variable storage space 
required. If more than 54K RAM is required then data must be 
stored as files which use filespace in other pages of RAM. For 
further details see section 3.3.5, HUmER MEMORY ORGANISAHON. 
However arrays of numerals or strings may be dimensioned as 
normal, the filing operation being totally transparent to the 
user. 

4.3.1 LINE NUMBERS 

Line Numbers are in the range 0 to 65535. Each line can be up 
to 254 characters long, including the line number. Extra lines 
can be inserted in the text by simply typing in a new line 
number between the two lines of interest. In view of this, it 
is recommended that line numbers are separated by an increment 
of 10 for each new line. Line numbers are stored in binary form 
and occupy a constant space in memory regardless of the number 
chosen. Each line number requires 2 bytes of memory. 

4.3.2 VARIABLE STORAGE 

HUNTER variables can be stored as either single or double 
precision floating point numbers. All simple variables are 
single precision giving 6 digit accuracy. Variables are 
designated by one alphabetic character (A-Z) followed by an 
optional alphanumeric character (A-Z) (0-9), giving up to 962 
separate variables. 

NOTE: Simple variable names ON, TO, IF, LN, AS, OR and PI should 
be avoided as these are also reserved words. Use as variables 
can lead to execution errors. 

4.3.2. 1 Nunerical Arrays 

Additionally, variables may form a one-dimension array using 
"DIM". Variable arrays may optionally be designated double 
precision giving 14 digit accuracy but with an additional memory 
overhead. Single precision arrays are designated by a number in 
parentheses following the variable name. 

A1(19),Z(2),C(X),A(20»T),AD(10),AZ(62) 

There can be 962 separately indentified arrays of simzle 
precision. ® 

NOTE: The number in parentheses can be an expression. Each 
variable occupies 5 bytes of HUNTER’S user memory in arrays 7 
bytes otherwise. ' 
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4. 3. 2.2 Double Precision 

Double Precision arrays are indentified by the symbol '!' 
followed by a number or expression in parentheses. Double 
precision variables have 14 digit accuracy. 

e.g. A1!(19),Zf(Z),CI(X),AA!(23) 

These are a further 962 arrays. 

Each double precision element occupies 9 bytes of HUNTER memory. 

4. 3. 2. 3 Default Values 

All numeric arrays default to 11 elements unless dimensioned 
with DIM statement. 

4.3.3 STRING STORAGE 

Single element string arrays are automatically assigned without 
a DIM statement. The default length is 20 characters. 

String names are defined exactly as variable names, with one 
alphabetic character (A-Z) and one optional alphanumeric 
character (A-Z, 0-9) followed by the '$' symbol giving a total of 
962 separately identified string variables. 

HUNTER supports strings of 8 bit characters including the full 
ASCII character set. 

The maximum length of any string is 254 characters, with a 
default size of 20 characters. 

DIM A1$(10,15) 

defines a string array of 11 elements, each of which can be up 
to 15 characters long. 

The maximum size of an array depends on the memory available. 
Examples of String variables are: 

A1$,Z$,C5$(22),H$(J),MM$(32) 

String variables can be initialised using LET, just assigned 
using =(equate), or READing from DATA statements. 
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The first element of a string array may be referenced with just 
the variable name, without the need for any number in 
parentheses. 

Example: 

A1$,Z$ Actually refer to the variables A1$(0),Z$(0) 

A single variable may therefore be defined as: 

ST$(0,10) and used as: 

ST$ 


4.3.4 MULTIPLE STATEMENTS 

HUNTER Basic supports multiple statements in a single program 
line. Statements are separated by a colonC:). 

Exanple: 

100 A=0:B=10: PRINT A,B:B=11 

The primary use of this feature is to reduce the program size. 
It may also make a program more legible. 

If a colon is used at the end of a line, END is assumed and 
program execution stops. 

The following statements cannot form part of a multiple 
statement: 

DATA 

WHILE 

WEND 

If REM is used in a multiple statement, it must be the last 
statement in the line. 
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.4 


EDITOR 


available in Hunter for creating and 
modifying text/Basic files. It may also be used for modifying a 
"Loaded” Basic program. 

TTiis may be accessed by typing EDIT as a direct Basic command, 
or using function key 3. 

edited. To return to Basic, the editor 
is Exited . This will re-process the text into the compressed 
form used by Basic. 


A file may also be saved from within the editor. 

For a full description of the facilities available within the 
Editor, see section 7. 
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KEYBOARD 


4.5.1 HUOTER computers are supplied with a standard QWERTY keyboard, 
see Fig 2.3, KEYBOARD LAYOUT. 


4.5.2 ELECTRICAL RE-DEFINITION 

Keyboard keys are each equated to the characters they represent 
by unique numerical codes, as listed in section 9.2, ASCII 
CHARACTER SET. These values are defined according to the 
American Standard Code for Information Interchange (ASCII). 

The value returned to Basic in, for instance, an INCHR statement 
is the numerical equivalent of the key pressed. 

The ASCII definitions of each key for the keyboard are contained 
in 116 consecutive RAM locations named KEYBUF. The upper shift 
keys are defined in the first 56 locations, followed by the 56 
lower shift keys. These memory locations form a 'map' of the 
physical keyboard. On power up, the HUNTER automatically 
defines these locations to a standard configuration. However, 
the programmer has the option to be able to define special 
keyboard arrangements. 

The schematic of the keyboard, see section 9.6 KEYBOARD MEMORY 
MAP, shows the value in KEYBUF for each key. 

As an example, consider the key fourth from the left on the top 
row. If it was required to program this key to be $ in upper 
case and S in lower case, two Poke operations would be required. 

POKE (KEYBUF), 36 
POKE (KEYBUF + 56),83 

It is important to note that on powering up HUNTER, the keyboard 
will revert to the standard version. The programmer should 
define the special keyboard requirements at an early stage in 
the program and ensure that the re-definition occurs each time 
the program is run. 

4.5.3 The codes used by the special control keys are listed in section 

2.4. 
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4.5.4 FUNCTION KEYS 

There are eight programmable function keys. They may be used as 
a quick method of entering frequently used commands or 
functions, or as eight separate interrupt keys. 


4.5.4. 1 Soft Keys 

On entering the Basic interpreter, the bottom line of the LCD 
displays the default values. These may be changed at any time 
with the KEY function as described in Part 5, BASIC FUNCTIONS. 
The screen only displays the first four characters, although the 
string may be up to fifteen characters long. 

The display of the soft keys is entirely optional, but they are 
always active no matter whether they are displayed or not. This 
feature is controlled with the KEY ON and KEY OFF commands. 

4. 5. 4. 2 Interrupt Keys 

The soft keys may be used to provide interrupts into Basic 
programs. The relevant Basic statements are: 

ON KEY (n) GOSUB line No. 

KEY (n) ON 
KEY (n) OFF 
KEY (n) STOP 

The interrupts are tested at the beginning of every Basic 
statement. Once a particular key has been pressed and has 
interrupted, then it cannot interrupt again, although other keys 
can still cause an immediate interrupt. However, one interrupt 
on a particular key can be held pending while its interrupt 
routine is executing. 


J 
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MEMORY ALLOCATION 


M.6.1 


' 4 . 6.2 


PROGRAM LIMITS AND MEMORY USAGE 


1 . 


2 . 


3. 


Ranses 

Variables: 

String arrays: 

Line numbers: 
Program line length: 


±9.99999E±126 

Up to 2544 characters per 
string 

0-65535 inclusive 
Up to 254 characters 
including line number 


Precision 

Single precision variables have 6 digit resolution. 
Double precision variables have 14 digit resolution. 

Memory overhead 

Program lines require 4 bytes minimum, as follows: 

Line number: 2 bytes 

Line length: 1 byte 

Carriage return: 1 byte 


Also each reserved word, operator, variable name character, 
special character and constant character requires 1 byte. 
Maximum program size in present versions: 54K Bytes (Page 0) 

DYNAMIC (RUN-TIME) MEMORY ALLOCATION 


1 . Symbol Table 

Entries occupy: 7 Bytes each 

Maximum symbol table size: 16K Bytes 

2. Single Precision Array 

DIM A(X) occupies (X-»-1)*5+7 Bytes 

3 . Double Precision Array 

DIM AI(X) occupies (X+1)«9+7 Bytes 

4. String Array Elements 

DIM A$(X,N) occupies (X-»-1)*N+7 Bytes 

5. Array Size 

Maximum number of elements in an array is 16,383. 
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HUNTER'S GRAPHICS 


HUNTER supports a graphics display of 240 x 64 pixels. Each 
point can be set to either white or black with the appropriate 
statement. Entering graphics mode is via the SCREEN statement, 
but this may be unnecessary since most of the functions which 
operate in graphics mode will automatically invoke the graphics 


The graphics statements in Basic are:- 

CHAR LOCATE 

CIRCLE POINT 

CLS PRESET 

LINE PSET 

SCREEN 1 enters graphics mode but also defaults the current 
character set to CHAR 0 and clears the display. 

The origin of the graphics screen is the top left hand corner, 
with the co-ordinates (0,0). So PSET(0,0) will set the corner 
pixel black. The origin for the LOCATE function, to determine 
the starting point for displaying ASCII characters, is (1,1) in 
the top left hand comer. 

Co-ordinates when specified are always absolute, ranging 0-239 
for X and 0-63 for y. If two pairs of co-ordinates are 
required, then the first pair may be defaulted to the last 
plotted position. 

The above functions can be made to draw characters or lines in 
either white on black or black on white. This is achieved by 
appending another parameter after the command. For example, to 
print inverse characters of medium size use;- 

CHAR 2,1 

The M’ means inverse. 

A detailed description of the above graphics commands can be 
found in Part 5, BASIC FUNCHONS. 

NOTE: Graphics mode on the HUNTER does not directly support the 
simple cursor manipulation codes, e.g: backspace, line feed, 
etc. The operating system generates the required cursor move- 
ments. 


VER.V09F 


PAGE 4-15 





BASIC PROGRAMMING 


SECTION 4.7 


M.7.2 GRAPHICS DEMONSTRATIONS 

The following program will draw a number of circles across the 
screen and back again; 

10 SCREEN 1 

20 FOR K=1 TO 167 STEP 4 
30 CIRCLE (K+30,32),30 
40 NEXT K 
50 CLS 

60 FOR K=167 TO 1 STEP -4 
70 CIRCLE (K+30,32),15 
80 NEXT K 
90 CLS 
100 GOTO20 


The 'LINE* command may also be used for drawing boxes as well 
drawing lines. The command: 


10 LINE (100,40)-(200,20) 

will draw a line from the co-ordinates 100,40 to 200,20, th® 
left hand corner of the screen being 0,0. The 
draw a box with the bottom left hand comer at point 100,20 and 
the too rieht hand comer at 200,20: 


10 LINE (100,40)-(200,20),1,B 

if the second parameter is used then the first must also be 
specified. The box may be filled in by appending 'F' to the 
second parameter. 


The Graphic's cursor can be positioned to any point on the 
screen by using the 'LOCATE' command. Pixels are set by using 
*PSET' or cleared by 'PRESET'. The following example will 
produce a dotted line across the screen: 

10 SCREEN 1 

20 FOR X=0 TO 239 STEP 4 
30 PSET (X,30) 

40 NEXT X 
50 END 
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MACHINE CODE CALLS 


4.8 HUJiTER is designed to be extremely versatile and flexible in its 

use. For some applications it is not possible to perform every 
function using pure Basic routines, usually for reasons of 
speed. It is possible to write machine code routines in these 
situations. 

Also covered in this section is some general guidelines in the 
control of HUNTER by means of PEEK and POKE to specified memory 
addresses. 

It should be emphasised that the use of features described here 
is not recommended for users unfamiliar with computing at 
machine code level. 

4.8.1 THE MACHINE CODE 

HUNTER uses the CMOS NSC-800 microprocessor, which provides an 
instruction set entirely compatible with the popular Z80 micro- 
processor. For that reason it is not proposed to go into detail 
about the facilities offered by machine code and users are 
referred to any of the standard books which cover the Z80. 

It is not recommended, ^Qwever, that the stack pointer register 
(SP) is used in a fashion incompatible with supporting inter- 
rupts. Standard use in .the form of subroutine CALLs, PUSHs and 
POPs, however, is supported. 

4.8.2 BASIC CALL 

To execute a machine code program the function:- 
CALL(addr) 

is used. This will pass control from Basic to the address. A 
machine code RET will return the user to Basic. 

4.8.3 PASSING SIM PLE PARAMETERS 

It is possible to pass information both from Basic to the 
'CALLed' program and return the information back to Basic. 

NSC-BOO is a trademark of National Semiconductor Inc. 

Z-80 is a trademark of Zilog Corporation Inc. 
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To set up outgoing data the ARG reserved word is used, format as 
sliDwn. The variable will be equated to the value in brackets. 

A = ARG (5) 

will cause the NSC800 internal registers C and E to be set up as 
follows:- 

C = 5 
E = 0 

The pair are set up as a 16 bit integer, hence:- 

ARG (10*256+30) 

causes 

C = 30 and:- 
E = 10 (decimal) 

when CALL is executed. 

These registers are used for compatibility with the CP/M style 
system call structure. 

To return data to Basic the program:- 

1000 X = CALL (addr) 

causes the value of variable X to take on the value contained in 
register A. 

M.8.il PASSING MULTIPLE VARIABLES 

To pass more than one integer between a 'CALLed' program and 
Basic the machine code linkage stack is used. 

This is controlled in Basic by PUSH and POP. In the routine:- 

1000 PUSH X,Y 
1010 A = CALL (addr) 

1020 Y = POPd) 

1030 X r POP(I) 

The integer values of X and Y are first placed on the stack and 
made available to the called routine, and then removed by the 
POP instruction back into their own variables. 
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When CALL is executed the register pair HL is used as an address 
pointer to the bottom of the stack on which the variables are 
placed 

X HIGH 
X LOW 
Y HIGH 
HU>Y LOW 

In other words HL is addressing the low byte of the most 
recently PUSHed variable. To access others then HL is 
incremented. These values may either be used by the called 
routine or modified and used by Basic. It is not necessary to 
preserve the contents of HL 

«.8.5 CONTROLLING HUNTER 


Section 9.7, MEMORY LOCAHONS and 9.8, PORT ALLOCAHONS, contain 
list's of available addresses of HUNTER parameters and system 
call addresses. The parameters may be written or read by means 
of PEEK and POKE operations. System calls may be used for 
functions such as the CLOCK or communications parameters. 

4.8.6 AVAILABLE MEMORY 

By subtle use of the DEFSEG statement, to address the required 
page, many places in RAM can be used for machine code implants. 
However, the only place in common RAM available (whatever DEF 
SEG is set to) is the serial communications buffer. Since the 
communications are active continuously on receive, take care not 
to let programs be corrupted. 50 hex bytes are available for 
small user programs at decimal address 62981 (see section 9.7). 

4.8. 6.1 MACHINE CODE IN BASIC 

The recommended method of storing machine code from BASIC is to 
store it in a dummy string array, a method for which is outlined 
below. 

a) First calculate the length of the machine code and dimension a 
string array with the required number of single byte elements 
using the formula: 

D=(N/2)-1 

where 

Nmumber of bytes needed for machine code. 

and 

Drnumber of single byte elements required in dimension. 
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To reserve 10 bytes of memory, the required dimension is DIM 
MC$(4,1). 

b) 

NOTE: After dimensioning, all the bytes will be set to zero. 

The start address of the reserved memory must be found. This is 
done as follows: 

Assuming the array name is MC$, the statement AD=VARPTP(MC$)-1 
will return the address of the first reserved byte in AD. 

c) 

To actually put the machine code into the array, a series of 
POKE statements are used, i.e: 

POKE AD,30,7, 14, 1,205,5,0,201 

NOTE: the machine code must be given as decimal numbers. 

d) 

Finally, to execute the machine code, all that is required is 
XrCALL(AD) 

4. 8. 6.2 

where X is a dummy variable and AD is the start address of the 
machine code as obtained in (b) above. 

NOTE: It is vitally important that DEFSEG is set to 0 when the 
CALL is executed. If D^SEG is altered in the program, DEFSEG=0 
must be executed before the CALL is executed. It is also 
important that no attempt be made to use the array which is 
holding the machine code in the E^sic program. 

PAGING IN MACHINE CODE 

In some applications the user may wish to access other pages 
from a machine code program. However, this is not a trivial 
matter and extreme care must be taken when using this facility. 
The user is recommended to read section 3.3.1 of this manual for 
full details on the HUNTER memory organisation before 
proceeding. 

In order to use the HUNTER paging, the machine code to switch 
the page muat be located in the common block of ram starting at 
49152 (COOOH). If the machine code is not in this block of ram 
the HUNTER will not be able to access the machine code program 
once the page has been switched. In order to ensure the machine 
code is located above 49152 (COOOH) the array used to hold the 
machine code is the last array dimensioned. Check the start 
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address of the array using VARPTR. If the address returned is 
still below 49152 , use a dummy array to push the start address 
of the array to above 49152. 


The paging control is accessed via an 'OUT (E0H),A' command, 
with the accumulator containing the required page number with 
bit 7 set to 1 

i.e: to switch to page RO, the accumulator should contain 
80H (128 decimal). 
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4.8.7 AVAILABLE RAM IN RO 

Basic source in HUNTER can extend for 54k, though there must be 
space for the symbol table. 

Fig 4.1, STORAGE USED BY BASIC, shows how program and arrays are 
stored in lower memory, simple variables and array definitions 
start at D700 and work down. The gap in the middle is available 
and unused, the amount being displayed using FRE. The limits 
are contained in memory locations ALIM and DEFLIM. The address 
contained at these locations indicates the position of the free 
space. 

Fig 4.1 STORAGE USED BY BASIC 


HUSKY memory 
limit 


SIMPLE 
VARIABLES & 
DEFINITIONS 


FREE SPACE 


BASIC 

PROGRAM 


0/S USE 


D700H 


(DEFLIM) 


(AUM) 

100H 
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It should be remembered that these locations are allocated 
dynamically and are entirely dependent upon the program and 
store. Also, if CLEAR or a new program line is inserted then 
the data storage is removed, so DEFLIM will point to the top of 
memory and ALIM to the top of the program. Hence, the program 
should be RUN before using these values. Clearly, if Basic is 
only used to start a large machine code program then there will 
be no variables and only a small amount of Basic source. 

4.8.8 STSTEM CALLS 

The system calls are all defined in section 3.5, CP/M INTERFACE. 
They should be used by CALLing location 5 with the relevant 
value in C for CP/M compatibility. NO guarantee is made of the 
contents of undefined registers on exit and in general all 
register contents will be destroyed. 

4.8.9 THE STACK 

The machine code stack pointer is initialised at switch on. It 
is not recommended that it should be moved as the system can use 
a considerable amount of stack space. Under no circumstances 
should routines be written which preclude the use of interrupts: 
V24 I/O uses them liberally. 


4.8.10 ON/OFF 

The key, as detailed in section 2.4.13, ON/OFF KEY, is software 
controlled. The keyboard should be scanned periodically in any 
user written software if manual power OFF is required. 

4.8.11 THE NSC800 

It is not proposed to go into software techniques, meaning of 
object code, etc., here as the NSC800 is totally software 
compatible to the Z80. A list of the machine code instructions 
is presented in section 9.4, NSCSOO MACHINE CODE. Users are 
referred to any tutorial book on the Z80 for detailed 
programming information. 

4.8.12 EXECUTION TIME 

Of interest in machine code loops, etc., is the execution time 
of the program. The number of cycles used by each instruction 
is detailed in section 9.4, NSC800 MACHINE CODE. The cycle time 
in HUNTER is 250ns. 
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If serial data is received, then the routines will be 
considerably slower due to interrupts. 
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PROGRAMMING TECHNIQUES 


4.9 To the programmer, most of HUNTER'S features are likely to seem 

familiar and quite comparable with many other, less portable, 
microcomputers. 

To the operator, HUNTER is likely to be quite different from 
anything he's encountered before. This fundamental divergence 
in experience can present a major challenge to the skill of the 
programmer. 

Because HUNTER operators tend to be newcomers to computer 
techniques, and worse, tend to capitalise on HUNTER'S unique 
physical characteristics by using it far away from the comfort 
of the computer room, considerable demands are placed on the 
quality of the programming. These demands are met by making 
programs as error-free and 'bullet-proof as possible, together 
with careful program structures. A HUNTER that interrupts a 
data entry sequence in the field with "Magnitude Error in 

Line " is not likely to be appreciated by the user, or 

worse, by his customers. 

Knowing that field operators would have difficulty in recovering 
from programming failures on the spot, HUNTER'S designers have 
provided a number of facilities that help overcome these 
difficulties. But because HUNTER'S programming has to have 
greater integrity than is ever required at the desk-top, there 
is no substitute for methodical discipline in programming. 

The contents of this section explain some techniques that are 
successfully used to provide reliable and ergonomically friendly 
user programmes. 

4.9.1 DATA CAPTURE TECHNIQUES 

A typical HUNTER application program consists of 3 segments: 

A 'Data Capture' segment 
An 'Inspection' segment 
A 'Transmission' segment 

All three segments are contained in a common program although 
treated as independent modules. All share a common database, 
the 'captured' information, generally stored in array 
structures. 

The operator (as opposed to the programmer) is given a limited 
range of options within this framework and never has access to 
the Basic interpreter. On power-up, HUNTER will typically 
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present a menu-style choice of options, often based on the 
segments or modules themselves. 

Once a module is selected, HUriTER will lead the operator through 
a question and answer sequence until his objective is achieved. 
Consider the following data capture program: 

10 REM TELEPHONE NUMBERS 

20 REM THIS PROGRAM CAPTURES AND STORES NUMBERS 
30 REM UP TO 6 DIGITS LONG. THEY CAN THEN BE 
40 REM RECALLED OR LISTED ON A PRINTER. 

100 REM MODULE 0 WHICH FUNCTION? 

110 PRINT "PLEASE CHOOSE A FUNCTION, TYPE '1' TO ENTER 
DATA; '2' TO INSPECT OR *3' TO TRANSMIT", 

120 INPUT A 
130 IF A=1 THEN 200 
140 IF A=2 THEN 300 
150 IF A=3 THEN 400 

200 REM MODULE 1 DATA CAPTURE 
210 DIM D(10) 

220 FOR N=1 TO 10 
230 INPUT D(N) 

240 NEXT N 
250 GOTO 100 

300 REM MODULE 2 INSPECT DATA 

310 PRINT "WHICH NUMBER DO YOU WANT TO INSPECT?" 

320 PRINT "PLEASE ENTER A NUMBER 1-101", 

330 INPUT N 
340 PRINT D(N) 

350 GOTO 100 

400 REM TRANSMIT THE DATA 
410 FOR N=1 TO 10 
420 LPRINT D(N) 

430 NEXT N 
440 GOTO 100 

This very simple program demonstrates the basic features of much 
more complex data capture routines, but has one dramatic failing 
: it is not "bullet proof". 

If the operator does not stick precisely to the sequence laid 
down, the program will soon encounter a problem and resort to 
error messages that will not help a non-programmer. Because of 
this, the great majority of effort in programming HUNTER 
applications is devoted to preventing occurances that might 
cause confusion. 


VER.V09F 


PAGE 4-24 


BASIC PROGRAMING 


SECTION 4.9 


HUNTER'S Basic interpreter contains many features designed to 
prevent the inexplicable happening in the field; but complex 
programs can sometimes outwit even their own authors! 

A simple solution to this problem is simply to add three more 
lines: 


50 ONERROR 500 

500 PRINT 'THAT CANT BE RIGHT - PLEASE TRY AGAIN" 

510 GOTO 100 

Now, all the error messages from the interpreter are intercepted 
and re-directed. The program simply tries again. This is fine, 
but the problem remains: the errors shouldn't be there in the 
first place! 

4.9.2 DATA STORAGE ARRAYS 

4.9.2. 1 Types of Arrays 

Captured data is generally held in array structures created 
within HUNTER'S very large memory. There are three types of 
array: 

Simple Variables 
Double Precision 
Strings 

Simple Variables are used for storage of decimal values of up to 
6 digit accuracy. 

Double Precision arrays store numbers up to 14 digit accuracy, 
but use more memory. 

NOTE: Both these types store much larger numbers than indicated, 
but only by truncating the least significant digits. For 
example, the number 12345678 entered as a simple variable would 
be stored and reproduced as 12345600. 

String Arrays store every character, whether numeric or 
otherwise, literally. They can have any number of characters 
(up to a maximum of 255 characters in each string). Facilities 
are provided for converting strings to numbers and vice versa. 

4. 9. 2. 2 Array Structures 

Every array is denoted by a name and placed in memory in a 
sequential table. Multiple arrays are packed in memory by Basic 
and accessed via a Symbol Table. 
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Individual array elements are identified by the array name and 
the element number, together with a character to identify the 
array type. For instance: 

NOTE: Arrays start from element 0 


A(10) is the eleventh element of simple variable array A. 

A!(2) is the third element of double precision array A! (quite 
different and independent from array A in the example above). 

A$(0)is the first element in string array A$. A$(0) is 

identical with A$, which can be used for shorthand, useful if 
there are multiple references to a single string in the program. 

In each case, the number in parentheses is the element number, 
and can be variable: A$(A) 

or an expression: A$(A»5) 

or another array element: A$((6)) 

Remember the element numbers start from 0! 

4. 9. 2. 3 Creating Arrays 

Arrays can only be created once: if a subsequent attempt is made 
to re-define an existing array, an error occurs. This is to 
warn the programmer that he may be accidentally duplicating an 
array name. 

If the statement DIM A$(1,6) is repeated at anytime an error 
message: 

•DIM Error 

will appear. 

This can be easily avoided by incorporating the DIM in a program 
sequence that is only executed once, and subsequently branched 
around. This is often called an Initialisation Sequence. A 
typical format is: 

10 IF Z<X) THEN 100 
20 DIM A$(l,6) 

30 Z=55 
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The variable Z is a flag, indicating that the program has been 
run before. (All variables are cleared to 0 by CLEAR or any 
change to program content, but not by power off or removing 
batteries). 

A slightly more sophisticated version is: 

10 IF ZOO THEN 100 
20 DIM A$(l,6) 

100 Z=Z+1 

Where Z acts both as a flag and as a counter of the number of 
times the program has been run, a very useful statistic! 

4. 9. 2. 4 Array Sizes 

Arrays are limited in size only by HUNTER'S memory space. 
Remember that arrays compete with program for space, 
automatically allocated by HUNTER'S operating system. 

Array size allocation is simplified by self-sizing. For this 
purpose, the Function FRE can be used as a variable. FRE 
provides the number of memory bytes remaining as follows; 

After NEW : The total memory available 

After program entry : The memory available for data 

After array definition : The memory remaining 

The number FRE can be used to automatically calculate the max- 
imum number of array elements possible for any given array type 
and to sign on informing the operator of this information. 

10 IF ZOO THEN 100 
20 N=2 

30 YrINT (((FRE(0)-7-N*7)/5)-1) 

40 DIM A(Y) 

100 PRINT 'TOTAL NUMBER OF ELEMENTS AVAILABLE :",Y 

Note that Y is taken as an integer (INT), that the symbol table 
entry (-7) is subtracted, that the element size is 5 bytes and 
that arrays start from zero, so the maximum number is one less 
(-1). N*7 is an allowance for the number of variables used in 

the subsequent program, assuming 7 bytes per variable. 


NOTE: arrays can also be copied to files. See section 4.14.1 
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A string array can be sized as follows: 

10 IF ZOO THEN 100 
20 N=2 

30 YrINT (((FRE(0)-7-N*7-256)/15)-1) 

40 DIM A$(Y,4) 

100 PRINT 'TOTAL NUMBER OF STRINGS AVAILABLE :",Y 

4. 9. 2. 5 Accessing Array Elenents 

Each element in a data array is accessible by its array index, 
expressed in parentheses, e.g: 

A$(235) 

is the 236th element in A$ 

NOTE: Array indexes must be within the range declared in the 
corresponding DIM statement. HUNTER Basic warns the programmer 
of any attempt to access an element outside the declared range 
with: 


•MAG Error 

Be especially careful with incrementing indexes like FOR NEXT 
loops. 

Array indexes often have a direct relationship to external 
variables, like stock codes. It is always preferable to 
directly access an array in this fashion in the interests of 
speed, rather than working sequentially through every element. 

If there are discontinuities (gaps) in the existing codes, or if 
the numbers are too large, a conversion table or algorithm may 
be needed. Since a literal table (one entry for every code) is 
likely to be very inefficient, it is generally worth putting 
considerable effort into deriving an efficient 'tree' structure 
for direct array access. 

4. 9. 2. 6 Array Searches 

There is often a need to search an array for an element of known 
content. In Basic, this procedure can be painfully slow. 

One solution to this dilemma is to use a specialised machine- 
code subroutine to search the array and return with the index of 
the target element. 
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4.9.3 


A much more practical method is the Basic function SRCH. 
DATA INPUT TECHNIQUES 


We are all familiar with the computer truism: 
"Garbage in - garbage out" 


out-of-range entries can cause fatal errors that are lust 
embaj-rassing in the office, but potentially disastrous in the 


4.9.4 


4. 9. 4.1 


incoming data against a predetermined mask and rejects entries 
^ain ° keyboard, warning the operator to try 


Equally important to the user is optimum use of HUNTER'S screen 
to provide clear, unambiguous prompt messages and input fields. 

USING HUNTER'S SCREEN 


positive effect to help its operator. Because the screen is 
entirely flexible, these notes are provided as a source of ideas 
rather than as instructions. 


This section refers to character-by-character use, more detailed 
a 7 direct dot addressing is available in Section 


The Virtual Screen 


HUNTER'S 40 X 8 character, LCD screen acts as a window to a much 
larger virtual screen. When characters are written to the screen 
from a Basic program they are always written to the virtual 
screen. Ihe commands available in Basic to move the window are 
'CLS', 'INPUT' and 'LOCATE'. 

'CLS' Clears the virtual screen and sets the window to the 
top left of the virtual screen, 

'INPUT' The execution of an 'INPUT' command will move the LCD 
window to the part of the virtual screen containing 
the 'INPUT' prompt. ^ 
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'LOCATE' The Lcxiate command will re-position the cursor in the 
virtual screen and will move the window so that the 
cursor remains visible. 

U,9,U,2 Cursor Addressing 

The cursor position can be commanded from a Basic program, 
allowing characters to appear anywhere on the screen. Cursor 
addressing is relative to the virtual screen, therefore 
characters may not appear on the LCD screen in text mode. 

The standard Basic format for cursor addressing is: 

LOCATE X,Y 

X and Y are the co-ordinate values expressed in decimal. 

^.9.^.5 The Standard Header Page 

All HUNTER programmes generated at HUSKY Computers feature a 
standard header page. The header page supplies vital information 
about the program and use of this format is strongly advocated 
to other users. 

The appearance of a suitable user header page would be:- 


I 20 Oct 1983 11:20:32 

I OPnONS 

I 1 = ENTER DATA 

I 2 = REVIEW DATA 

} 3 = AMEND DATA 

I M = TRANSMIT DATA 

I PLEASE ENTER OPHON NUMBER ? 


4. 9. ^.6 Dynamic Screens 

A vital ergonomic factor in HUNTER program design is 
reassurance. Many, perhaps most, HUNTER operators have never 
worked with any kind of computer before and are likely to have 
some suspicion about this example of 'advanced technology'. 

The crucial point is that HUNTER MUST COMMUNICATE WITH THE 
OPERATOR. If it doesn't he'll soon become frustrated at some 
situation he doesn't understand and resort to 'traditional' 
solutions - gently encouraging it with a series of sharp blows 
or worse! 


VER.V09F 


PAGE 4-30 


BASIC PROGRAMING 


SECTION 4.9 


4.9.5 HELP STATEMENT 


The HELP facility provides a means 
programs to display text for operator 


of breaking 
assistance. 


into normal 


After the HELP text has been read control 
main program, as if nothing had happened, by 

acrairt ' 


is returned to the 
pressing the 'HELP' 


4. 9. 5.1 The Help Vector 


performed. The start position of the text can be 
set under Program control. This is achieved by the pair of ram 
l^ations VECTOR', indicating the memory address of the start 
Of text. This is controlled by the HELP function in Basic. 

VECTOR can also be set by POKE. 

4. 9. 5. 2 Text Storage 


Help text is stored by means of REM statements, 
storing of ASCII text within programs. 


which allow 


The address in the Help vector points to the start of the line 
number. The Help program will skip forward over the first four 
bytes, checking the REM td<en and then displaying the text. 

NOTE: The REM token is stored as 143 Decimal, (SFHex). 

Fig 4.2 TEXT STORAGE, shows how the following line of Basic 
source code is stored: 


10 REM ABCDEFGHI 


Fig 4.2 TEXT STORAGE 


OE 

OA 00 

8F 

41 42 43 44 45 46 47 48 49 

OD 


LINE LINE 

LENGTH NUMBER TOKEN 


ASCII TEXT 


CR LINE 
TERMINATOR 
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M.9.5.3 HELP Text Display 

The software which controls HELP will scroll forward through the 
lines of Basic text, or pseudo-Basic text, until the verb found 
is not a REM. Scrolling backwards is also allowed until a line 
is found without a REM. In each case, further scrolling is not 
allowed. 

M.9.5.^ Storing the Current Display 

The contents and cursor position of the screen are not lost 
while in HELP mode. On exit from HELP mode, the screen and 
cursor are restored to their states prior to HELP mode entry. 

4. 9. 5. 5 HUMTER Action during FCLP 

When a program is interrupted for FELP display all normal action 
is suspended. Serial data reception will continue up to the 
capacity of the receive buffer. If handshaking is enabled then 
it will continue in a transparent fashion. 

Programs will continue after the HELP key is pressed again. 

HELP will be entered during any scan of the keyboard, whether 
for status or waiting for an actual key depression. 

^.9.5.6 Graphics Mode 

Because HUNTER'S graphics screen cannot be re-created from RAM 
memory, HELP text would destroy the contents of the screen if 
allowed during graphics mode. For this reason, HELP is 
inhibited in graphics mode and help key depressions are ignored. 
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POWER WARNING 


M.10 When HUNTER'S batteries become exhausted a power warning message 
will appear on the screen. Normal operation will continue, but 
keyboard entries will be punctuated by warning tones and 
repetition of the power warning message until the battery state 
is rectified either by replacement of primary cells or 
recharging of Nickel -Cadmium cells, if installed. 

Eventually, if the warnings are ignored, HUNTER will shut down 
and refuse to operate further. 

Every HUNTER has to pass a stringent operating test in this low 
power regime. However, it is strongly recommended that operator 
training procedures and user programs are structured to avoid 
continued operation when warnings become persistent, especially 
when rechargable cells are used. 

The power warning sequence may be misleading if RS-232 
communications are used infrequently. When HUNTER'S 
communications system is activated power drain increases 
significantly. This increase can cause the power warning stage 
to be missed altogether, and instead cause HUNTER to shut down 
without warning. 

While this is not hazardous, it can be very confusing for an 
operator who does not know what is wrong. Because of this it is 
recommended that user programs with infrequent communication 
requirements use a test routine. This activates the 
communications package, and then tests the power state before 
restoring HUNTER to normal. This routine is used at the start 
of every data entry sequence. 

If batteries become exhausted whilst communications are in 
progress, then normal power warning messages will appear once 
the keyboard operation is resumed. 

NOTE; Power warning messages only occur when keyboard entries 
are in progress. 

SAMPLE WARNING SUBROUHNE 

20 OUT 132,1 
30 J=INP(2):0UT132,0 

40 IF J AND 4 = 0 THEN RETURN 
50 CLS 

60 PRINT "PLEASE CHANGE MY BATTERIES!" 

70 BEEP: BEEP: BEEP: BEEP 
80 RETURN 
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This program operates as follows; 

1) The power status is available as bit 2 in HUNTER port 2. 

0 r power OK, 1 = Low Power state. 

2) Line 20 energises the RS-232 serial interface. 

3) Line 30 reads the power state from port 2, and then closes 
down the interface to conserve power. 

4) Line 40 checks the power status bit. 

5) Line 50-80 Display a warning and ring HUNTER'S belli 
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OFF-LINE PROGRAM STORAGE 


4.11 Most HUNTER applications require storage of users' Basic source 
programs in an easily accessible bulk-memory system for support, 
updating, exchange and maintenance. 

One very popular method of storing HUhTTER programs is in user’s 
multi-access mainframe database systems, although minis, micros 
and other HUNTERs are also used extensively. HUNTER'S ability 
to communicate freely with these other systems is vital to 
supporting its programming and application. 

This section deals with both manual and programmed source code 
loading and unloading using Basic's complementary LLIST and 
LLOAD commands. 

4.11.1 LLOAD 

LLOAD is the command for loading Basic source programs into 
HUNTER. It may be used' to load entire programs or to modify 
existing ones by appending or overwriting lines. 

LLOAD can be used with any of the communications protocols 
detailed in Part 6, COMMUNICATIONS. During LLOAD no text is 
echoed to the screen, to speed up the facility. Certain 
speed/protocol limitations are detailed below. 

4.11.1.1 Manual Control 

To enter program lines, simply type 'LLOAD' followed by carriage 
return. HUNTER will then load to memory source text presented 
on the serial port. Note that syntax is checked on a line by- 
line basis and that if an error is detected, the LLOAD will 
terminate and a 'SYX Error' will be displayed on the screen. 

If the program provided overflows the memory space available, a 
'MEM Error' will appear. 

LLOAD mode can be terminated by pressing 'ESC on HUNTER'S 
keyboard or 'power off. (Data will not be lost). 

Alternatively, an 'ESC character sent over the interface will 
return control to the keyboard. 
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^.11.1.2 Programned Control 


logically, it is difficult for a program to append to or modify 
Itself, since the sequence controlling the modification may be 
modified as well! However, HUNTER programs can contain 
sequences that will command a remote processor to send program 
text and then accept that text as Basic source. 


Current versions of HUNTER Basic do not support LLOAD as a 
program statement, e.g. 100 LLOAD. However, the 'Logical 
Keyboard' Flag has the same effect as LLOAD and can be commanded 
in a program as a 'POKE' instruction. By setting the flag to 
returning to interpreter mode, 
^ER is configured to accept new program lines. These lines 
may overwrite the lines originally used to enter the LLOAD mode. 

fading may be terminated by sending an unnumbered 'RUN' state- 
ment which will cause execution to re-commence from the start of 

program, making the load sequence 
virtually transparent to the operator. 


A possible program format might be: 


100 REM Program reload routine 

ipn program name", X3$ 

130 X3$ ’ PI®®* transmit file name", 

140 POKE LK,1 : REM This sets the logical keyboard as the 

serial input port 

150 END : REM Returns control to the interpreter 


.The new program lines now load 


. The last line transmitted is unnumbered RUN, which executes: 

20 tore the logical keyboard 

20 PRIhrr "New program loaded OK : Continue?" 

Variable LK is the address of IPFLAG. addressp^ or 
locations may be found in section 9.7, M^ORY mcA^Ns^ 

HUNTER'S input buffer ensures that the first llnp 

captured, no matter how quickly the distant co^Juter res^^^fs! ^ 
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4.11.1.3 IMPORTANT NOTE 


In present versions of HUNTER operating system, any alteration 
to program content, including deletion of lines, automatically 
clears all variables and arrays. This is essential to HUNTER'S 
operation, but means that data cannot be carried across reload 
boundaries. Data copied to files is not affected, however. 


4.11.2 LLIST 


LLIST is the principal method of copying and recording HUNTER 
programs. 

Invoking LLIST causes program lines to list sequentially from 
the lowest line number or from a line number specified as an 
argument in the LUST. Examples are : 

LLIST Lists an entire program 
LUST 170 Lists from line 170 

LUST 2133 Lists from 2133 or, if 2133 does not exist, from the 
next highest line. 

LUST terminates when all line numbers are listed, when 'ESC' is 
pressed or when HUNTER is powered down. Data will not be lost 
if HUNTER powers down during a listing. 

LLIST cannot be incorporated in a program, and is only available 
for manual use. 

Protocol and format selections made in HUNTER'S communication 
package are observed transparently by LLIST. Carriage Return 
terminator characters are provided at the end of each program 
line, line feed and null characters are optional. 

IMPORTANT NOTE 

Remember that HUNTER'S communication system needs to power up to 
its RS-232 state for transmission to occur. This power-up will 
cause an off-to-low transition that many systems will read as a 
single, spurious, character. This event only occurs once and 
can be avoided by powering up the interface prior to activating 
a receiving device. Methods of pre-powering the interface 
include : 


LPRI NT " " 
OUT 132,1 


REM the interface powers up automatically 

REM Direct control of the communications inverter 
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Remember that once powered up, the RS-232 output remains active 
until HUNTER is powered down or the inverter is commanded 'off 
by ; 

OUT 132,0 

HUNTER power consumption increases substantially during RS-232 
transmission with corresponding reduction in battery life. 

It should be noted, however, that if the RS-232 line is powered 
off further serial transmission will be lost unless the inter- 
face is powered up again, by: 

OUT 132,1 

NOTE: The interface will not power-up automatically with a 
simple LPRINT statement with no argument. 

4.11.3 SPEED/PROTOCOL LIMITATIONS 


It is always advisable that some form of protocol handling is 
established between HUNTER and associated computers. 

Some multi-access mainframes and some popular microcomputers are 
unable to support any form of protocol, however. 

In these cases, HUNTER will generally support direct program 
transfer at speeds of 1200 baud or less. At higher speeds, 
HUNTER'S input buffer may overflow leading to loss or truncation 
of lines. At 1200 baud, the buffer smooths the flow of incoming 
program through HUNTER Basic's syntax checking routines. 

Problems with truncation will invariably lead to the load 
operation being aborted and a 'SYX Error' message being dis- 
played, since the Interpreter will not accept partial lines. 

The capability of supporting simple 1200 baud communication is 
invaluable in many situations. 

4.11.4 COfWNICATIONS WITH DATABASES 


A very useful HUNTER feature is the ability to 
directly with mainframe databases using TERM. 


communicate 


This interactive mode can be used manually to establish loeon 
procedures, passwords, etc., before attempting to transfer or 
copy files or inspect data ^ 


manually can in most cases be implemented 
in HUNTER Basic as automatic features of the user's program once 
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protocols, etc, have been finalised. Such sequences can present 
inputs to the mainframe and inspect the reply for keywords like 
'READY' or simple cursor prompts. 

MOTE: Many mainframes are unpredictable in the response they 
provide to login sequences, with variable 'welcome' or 'news' 
messages. Make sure your automatic sequence is robust enough to 
handle these eventualities! 

Some general points about database communications should be 
noted: 

4.11.4.1 Rate 

Communication occurs generally at 300 baud, although other 
configurations are possible. Remember that the screen 
character generator will display all ASCII characters, even if 
they are not shown on the keyboard. 

Other rates encountered on dial-up systems are 110 (very rare) 
and 1200, but only with sophisticated modems. 

4.11.4.2 Parity 

Dial-up systems can expect any of even, odd or no parity 
selections. Transmit and receive parities are generally the 
same. Always use receive parity if it is available - the 
occasional appearance of the parity error symbol is a useful 
indication of bad lines. Remember that telephone lines can be 
bad in one direction only. 

4.11.4.3 F\Jll/Half Duplex 

Database systems vary widely in the use of full or half duplex 
operation. 

Full duplex occurs when the host system 'echoes' every received 
character back to HUNTER. In this mode, HUNTER'S transmission 
echo should be selected 'off so that characters typed on the 
keyboard only appear on the screen if they have completed the 
whole circuit of HUNTER - Mainframe - HUNTER. 

Basic routines can check full duplex replies as an absolutely 
secure communication protocol, provided the mainframes' own 
messages don't confuse the issue. 
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If the echo switch Is left * 011 ', double characters will appear 
on the screen. This in no way affects communication, but makes 
outgoing messages hard to read! 

Half duplex occurs when the host does not echo characters back 
to HUffTER. In this situation, the echo switch should be 'on' to 
allow outgoing messages to be read by the operator. This method 
does not guarantee that data sent to the host is being correctly 
Interpreted. 

A third mode. Simplex, occurs when data is sent in only one 
direction at one time and is otherwise similar to Half duplex. 
HUNTER is not concerned which mode is in use. 

^.11.^.^ Protocol 


Unfortunately, very few dial-up databases support any kind of 
protocol, so that generally HUNTER'S 'none' option should be 
used. Note that ^200 baud is the fastest recommended speed for 
no protocol program loading. 

However, some systems do support 'XON/XOFF' although implement- 
ations vary between computers - seek advice from HUSKY Computers 
if difficulty is encountered. 

^.1 1.^.5 Other Parameters 

The setting of 'NULL' and 'LF' are generally not material in 
mainframe communication, so that 'O' is recommended for NULL 
count. See below for LF. 

^.11.4.6 Termlnabor 


HUWp s 'ENTER' key generates CR (Carriage Return), but some 
owinframes expect other terminators. Examples are Control C and 
LF (Line Feed), or 'New Line'. Consult your computer manual for 


^.11 . ^.7 Delete 


^.11.5 


HUNTER'S DEL (Delete) key generates 'rubout'. Few mainframes 
recognise this, or in many cases allow any deletion at all! 
Cursor left' may work in some cases. 


ACOUSTIC COUPLERS 


Good quality oooimunloatlon can often be achieved over aurorlaln. 
dlatancea with acouatlc couplera at 300 baud, but thla method iS 
not recommended for routine dally use. 
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4.11.6 EXTRA DOCUMENTATION LINES 

It is worth knowing that source files kept on computer systems 
can have further documentation within them by using unnumbered 
'REM' lines, e.g. 

100 PRINT "HELLO" 

REM This line of text will be ignored by HUNTER only line 
100 will load into HUNTER. 

This prevents loading unnecessary text. Naturally, these lines 
can only be created on the host or database computer. 
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AUTO POWER FEATURE 


4.12.1 Basic supports several powerful functions associated with the 
POWER key. Basic programs can control precisely what occurs on 
switch on, or even not allow HUNTER to be turned off. The 
following commands and statements are available: 

ON POWER GOTO 
ON POWER RESUME 
P0l€R CONT 
POV/ER n 
POWER OFF 
POV/ER OFF RESUME 


4.12.2 DEFAULT CONDITIONS 

The power key behaves as normal - at any stage it can be used to 
turn HUNTER on or off. The current execution position is lost 
on turning the power off, and turning it back on returns to the 
File Manager. However the current Basic program and variables 
are retained. 


4.12.3 POWER CONT 

a) The power key is disabled. 

b) The automatic timeout power down (if no key is pressed within 
a set period of time) is disabled. 


4.12.4 POWER n 

a) This command overrides a previous POIVER OFF. 

b) n refers to the automatic power down timeout: 

1 ) n must be in the range 10-255 or 0 

2) n=0 is no automatic timeout 

3) n is in mutiples of 5 seconds 


4.12.5 POWER OFF 

a) Turns the power off. 

b) When power is turned on, Basic program execution starts at 

the beginning. 
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4.12.6 


4.12.7 


4.12.8 


4.12.9 


POWER OFF RESUME 

As POWER OFF, but turning HUNTER on continues execution where it 
left off. 

ON POWER GOTO 

When the power button is hit (during program execution) program 
execution goes to the specified line number. 


ON POWER RESUME 

a) Powering down proceeds as normal. 

b) Powering up begins program execution where it left off. 


Timeouts 

HUNTER has an automatic timeout (see section 2.8.8). This can 
be modified using POWERn. If HUNTER has been switched off, the 
power down timeout is set back to the default of 5 minutes 
unless CONT (see section S.4.3.4) or Power OFF RESUME (see 
section 4.12.6) has been used. 


VER.V09F 


PAffi 4-43 



BASIC PR0GRAff4ING 


SECnON ^.13 


^. 13.1 


^. 13.2 


^.13.3.1 


^.13.3.2 


^.13.3.3 


FILE HANDLING 


HUFTTER's Basic interpreter provides the user with the necessary 
commands and statements to communicate with the File Manager as 


CLOSE 

MAXFILES 

EOF 

NAME 

INPin’# 

OPEN 

KILL 

PRINT# 

LOC(n) 

WRITE# 


rill, ® Manager supports the use of sequential access 

»™TER's rah memory, but HUNTER'S 

^dlni ® 


File Numbers 


When flies are OPENed for input or output they are assigned a 
•file number' 1® specified by the 'AS' parameterf The 
HiJi^LES specified in 
onTl^'taken specified a default value of 
™*er* referred to by its 'file 


File Handling Commands 




When files have been OPENed for reading nr 

^he7ir;*‘‘ th77nd*orm7 

EOF 


ev“y7wUTl sUtement foi^7^y‘’me“'an lttempt'’to“'^*/'^®'' 
the end of file will produce an error. attempt to read past 
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4.13.3.4 

INPUT# 

Tliis coninand is used for reading data from a file. 

4.13.3.5 

KILL 

Used for deleting files from within a Basic program. The file 
must first be CLOSEd if it has previously been OPENed for 
reading or writing. 

4.13.3.6 

LOC(n) 

This will return the number of records that have been read or 
written to a file. The parameter (n) refers to the 'file number' 
associated with the file. 

4.13.3.7 

MAXFILES 

Sets the maximum number of files that may be opened simul- 
taneously; if it is not specified a default value of one is 
taken. MAXFILES will perform a CLEAR operation when it is 
executed, destroying all symbol table entries. Therefore it 
rrust be defined at an early point in the program. 

4.13.3.7 

NAME 

This will re-name a file from within a Basic program. 

4.13.3.8 

OPEN 

Before a file can be read or written to it must first be OPENed. 
The OPEN command has as one of its parameters 'FOR' which has to 
be specified with one of three options which are: 

OUTPUT = Opens and clears file ready for output. 

APPEND = Opens a file for output. Records written are added to 
the end of the file. 

INPUT = Opens a file for reading. 
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44.13.3.9 PRINT# 

Data is output to the file. Each variable must be delimited by 
a comma. 


U. 13. 3. 10 WRITE# 

Data is output to the file, variables do not need to be 
delimited by commas. 
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ERRORS AND WARNINGS 


4.14 HUNTER'S Basic Interpreter will display one of a number of 
messages on an error occurring. 

The messages have three characters, generally with a line 
number. The meaning may be found with reference to the 
following Table 4.14. They are aimed at experienced 
programmers. 

Each error has an error number. This is the value returned by 
the ERR verb and is useful during error trapping. 
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TABLE ^1.14 


MESSAGE 

NO. 

MEANING 

ARG 

0 

ARGUMEMT ERROR: A function has been called 
with an out of range argument. 

STX 

1 

SYITAX ERROR: Incorrect syntax in a Basic 
statement. 

CSK 

2 

CONTROL STACK ERROR: Incorrect F0R...NEXT; 
WHILE...WEND or GOSUa..RETURN construction. 

SSK 

3 

SYSTEM STACK ERROR: Attempt to POP a non- 
ex istant variable. 

DIN 

4 

DIRECT INPUT ERROR: Use of a meaningless 
Basic statement as a command, e.g. NEXT. 

DIM 

5 

DIMENSION ERROR: Attempt to redefine an 
existing variable. 

FP 

6 

FLOATING POINT ERROR: Illegal maths 
operation, e.g. B=A/C v*iere C=0. 

LNo 

7 

LINE NUMBER ERROR: Reference to a non- 
existent line number. 

SQR 

8 

NEGATIVE SC3UARE ROOT: 

MAC 

9 

MAGNITUDE ERROR: Reference to an array 
element larger than the array dimension. 

RD 

10 

READ ERROR: The data statement is either 
invalid or non-exlstant. 

MEM 

11 

STORAGE OVERFLOW: Variable storage or array 
overflowed available memory. 

ARY 

12 

ARRAY ERROR: Use of an element in an un- 
defined array. 

BAS 

13 

BASIC SOURCE ERROR: Attempt to run a non- 
Basic program. 

HLP 

14 

HELP SOURCE ERROR: The HELP statement has 
an Illegal line number reference. 
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TABLE 4. 

14 Contd.. 


MESSAGE 

NO. 

MEANING 

TYP 

15 

TYPE MISMATCH ERROR: Received string data 
type instead of numeric. 

STR 

16 

STRING COMPLEXm ERROR: Insufficient space 
to manipulate a string expression. 

RES 

17 

RESUME WITHOUT ERROR: 

FNF 

18 

FILE NOT FOUND: Reference to a non-ex istant 
me. 

IFN 

19 

ILLEGAL FILE NAME: Filename does not 
conforiTj to standards of file names. 

FOP 

20 

FILE ALREADY OPEN: 

FNO 

21 

FILE NUMBER ERROR: File number greater than 
MAXFILE. 

FCL 

22 

FILE CLOSED ERROR: 

FOO 

23 

FILE OPEN FOR OUTPUT ERROR: 

FOI 

24 

FILE OPEN FOR INPUT ERROR: 

WWD 

25 

WHILE/WEND ERROR: WHILE without WEND or 
without WHILE. 

DSK 

26 

DISK ACCESS ERROR: 

??? 

27-255 

USER DEFINED ERROR: 
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INDEX TO BASIC FUNCTIONS 


5.2.1 

ABS 

Function 

5.2.2 

ARC 

Function 

5.2.3 

ASC 

Function 

5.2.i| 

ATN 

Function 

5.3.1 

BEEP 

Command 

5.4.1 

CALL 

Statement 

5.4.2 

CHAR 

Function 

5.4.3 

CHR$ 

Function 

5.4.4 

CIRCLE 

Statement 

5.4.5 

CLEAR 

Command 

5.4.6 

CLOSE 

Statement 

5.4.7 

CLS 

Command 

5.4.8 

COM 

Comnand 

5.4.9 

CONT 

Conmand 

5.4.10 

COS 

Function 

5.4.11 

CRT 

Command 

5.4.12 

CUROFF/ 

CURON 

Command 

5.5.1 

DATA 

Statement 

5.5.2 

DATE$ 

Function 

5.5.3 

DAY$ 

Function 

5.5.4 

DEFSEG 

Command 

5.5.5 

DELETE 

Command 

5.5.6 

DIM 

Statement 

5.6.1 

EDIT 

Cormand 

5.6.2 

END 

Statement 

5.6.3 

EOF 

I/O Function 

5.6.4 

ERR/ERL 

Function 

5.6.5 

ERROR 

Statement 

5.6.6 

EXP 

Function 

5.7.1 

FILES 

Command 

5.7.2 

FIX 

Function 

5.7.3 

FOR 

Statement 

5.7.4 

FRE 

Statement 

5.8.1 

GOSUB 

Statement 

5.8.2 

GOTO 

Statement 

5.9.1 

HELP 

Statement 

5.10.1 

IF 

Statement 

5.10.2 

IF.. THEN.. 
ELSE 

Statement 


Returns absolute value of argument 
Sets up argument for CALL 
Returns decimal equivalent of string 
Returns Arc-Tangent of argument 

Generates tone from sound generator 

Calls machine-code subroutine 
Specific character set in graphics mode 
Returns string equivalent of argument 
Draws circle on LCD 
Clears all variables 
Closes files 

Clears the display screen 
Activates/deactivates communications 
interrupt 

Continues execution of program 
Returns cosine of argument 
Switches console to RS-232 port 
Switches cursor off and on 


Holds data for use by program 
Returns current date string 
Returns current day string 
Defines RAM page 
Delete program lines 
Initialises arrays 

Enters Basic editor 

Terminates execution 

Detects end of file 

Returns error code/line number 

Simulates Basic error 

Returns e to the power of the argument 

Displays current files 
Strips argument to integer 
Starts FOR...NEXT loop 
Returns number of free bytes 

Branches to subroutine 
Branches to alternative line 

Initialises HELP key text pointer 

Conditional branch 

Conditionally executes one of two 

statements 
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5.10.3 

INCHR 

I/O Statement 

5.10.4 

INKEY 

I/O Statement 

5.10.5 

INKEY$ 

I/O Statement 

5.10.6 

INP 

I/O Statement 

5.10.7 

INPUT 

Statement 

5.10.8 

INPUT USING Statement 

5.10.9 

INPUT# 

I/O Statement 

5.10.10 

INSTR 

Function 

5.10.11 

INT 

Function 

5.11.1 

JSR$ 

Function 

5.12.1 

KEY 

Coinnand 

5.12.2 

KEY(n) 

Command 

5.12.3 

KILL 

Command 

5.13.1 

LEFT$ 

Function 

5.13.2 

LEN 

Function 

5.13.3 

LET 

Statement 

5.13.4 

LINCHR 

I/O Statement 

5.13.5 

LINE 

Statement 

5.13.6 

LINPUT 

I/O Statement 

5.13.7 

LIST 

Cormand 

5.13.8 

LUST 

I/O Statement 

5.13.9 

LLOAD 

Statement 

5.13.10 

LN 

Function 

5.13.11 

LOAD 

Command 

5.13.12 

LOC 

I/O Function 

5.13.13 

LOCATE 

Conmand 

5.13.14 

LOG 

Function 

5.13.15 

LOPCHR 

I/O Statement 

5.13.16 

LPRim" 

I/O Statement 

5.13.17 

LTRON 

I/O Statement 

5.14.1 

MAXFILES 

I/O Statement 

5.14.2 

MID$ 

Function 

5.15.1 

NAME 

Command 

5.15.2 

NEW 

Command 

5.15.3 

NEXT 

Statement 

5.16.1 

ON BREAK 

I/O Statement 

5.16.2 

ON COM 

I/O Statement 

5.16.3 

ON COMMS 

I/O Statement 

5.16.4 

ON ERROR 

Statement 

5.16.5 

ON GOSUB 

Statement 


SECTION 5.1 


Returns single character from keyboard 

Returns keyboard status 

Returns single character from keyboard 

if input pending 

Returns value at port address 

Returns data input from keyboard 

Validates data input from keyboard 

Input data from file 

Returns position of second string in 

first string 

Returns integer part of argument 

Returns fixed-field string 

Initialises soft keys 
Activates/deactivates soft keys 
Deletes file 

Returns left part of string 

Returns lengths of string 

Assigns value of variable 

Returns single character from RS-232 

Draws straight line 

Returns entry from RS-232 

Lists program at LCD 

Lists program at RS-232 

Loads program from RS-232 

Returns natural logarithm 

Loads program from file 

Number of records read/written 

Sets cursor position 

Returns logarithm to base 10 

Sends single character to RS-232 

Outputs to RS-232 

Sends trace output to RS-232 

Maxinwm no. of files to be opened 
Returns mid portion of string 

Re-names file 
Initialises program space 
Concludes FOR.. .NEXT loop 

Vectors program on BREAK key 
Vectors program on communication 
Vectors program on COMMS failure 
Vectors program on Syntax error 
Conditional branch to subroutine 
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5.16.6 

ON GOTO 

Statement 

5.16.7 

ON KEY 

I/O Statement 

5. 16.8 

ON POWER 

I/O Statement 

5.16.9 

ON POWER 

5.16.10 

RESUME I/O Statement 

ON TIME$ 

Statement 

5.16.11 

OPCHR 

Statement 

5.16.12 

OPEN 

I/O Statement 

5.16.13 

OUT 

I/O Statement 

5.17.1 

PEEK 

Statement 

5.17.2 

PI 

Statement 

5.17.3 

POINT 

Statement 

5.17.4 

POKE 

Statement 

5.17.5 

POP 

Statement 

5.17.6 

POS 

Statement 

5.17.7 

POWER 

Statement 

5.17.8 

POWER CO NT 

Command 

5.17.9 

POWER OFF 

Conmand 

5.17.10 

POWER OFF 



RESUME Command 

5.17.11 

5.17.12 

PRINT 

Statement 

5.17.13 

PRINT# 

I/O Statement 

5.17.14 

PSET/PRESET Statement 

5.17.15 

PUSH 

Statement 

5.19.1 

READ 

Statement 

5.19.2 

REM 

Statement 

5.19.3 

RESTORE 

Statement 

5.19.4 

RESUME 

Statement 

5.19.5 

RETURN 

Statement 

5.19.6 

RIGHT$ 

Function 

5.19.7 

RND 

Function 

5.19.8 

RUN 

Command 

5.20.1 

SAVE 

Command 

5.20.2 

SCREEN 

Coirmand 

5.20.3 

SGN 

Function 

5.20.4 

SIN 

Function 

5.20.5 

SOUND 

Command 

5.20.6 

SPACE$ 

Function 
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Conditional branch 
Vectors program on soft keys 
Vectors program on POWER key 

Restarts program on power up 
Vectors program on system time 
Outputs 1 or more ASCII characters 
Opens file for input/output 
Outputs to specified port 

Returns decimal byte value of memory 
locations 

Value of PI r 3.14159 
Returns condition of pixel 
Sets memory location with decimal 
value 

Returns value from machine 

code linkage/stack 

Returns cursor position 

Specify auto time off 

Disables power off key and time outs 

Switches HUNTER off 

Switches HUNTER off 
Outputs to LCD 

Output data to file 
Set/re-set pixel 
Puts value onto machine code 
linkage stack 

Returns value from DATA statement 
Enters remarks to Basic text 
Resets Read pointer 
Restarts program at specified line 
Returns from subroutine 
Returns right portion of string 
Produces random number 
Starts a program execution 

Writes program to file 

Changes screen mode 

Returns a value for the sign of its 

argument 

Returns Sine of argument 
Generates specified tone 
Returns string of spaces 
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5.20.7 

5.20.8 

5.20.9 

5.20.10 

5.20.11 

SPC 

SC3R 

SRCH 

STOP 

STR$ 

Function 

Function 

Function 

Statement 

Function 

5.20.12 

5.20.13 

STRINGS 

SWAP 

Function 

Function 

5.21.1 

5.21.2 

5.21.3 
5.21. i4 

TAB 

TAN 

TIMES 

TRON/TROFF 

I/O Statement 
Function 
Function 
Command 

5.23.1 

5.23.2 

VAL 

VARPTR 

Function 

Function 

5.2H.1 

5.24.2 

5.24.3 

WAND 

WHILE.. WEND 
WINCHR 

Command 
Statement 
I/O Statement 

5.24.4 

5.24.5 

WINPUT 

WRITE# 

I/O Function 
I/O Function 
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Prints spaces 

Returns square root of Its argument 
Returns target string array position 
Terminates program execution 
Returns string equivalent of a 
numerical argument 
Returns string of characters 
Exchange contents of two variables 

Formats Print output 
Returns tangent of argument 
Returns current time string 
Turns trace on/off 

Returns numeric value of string 
Returns address of variable 

Defines wand decode software 
Conditional execution of statements 
Inputs a single character from an 
optical wand 

Inputs string from optical wand 
Write data to file 
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5.2.1 Function 

ABS(N) returns the absolute value of the argument. 

Syntax 

ABS(N) where N can be a variable, number or result of 
numeric expression. 

Exaoples 

Y=ABS(-12.345) returns Y=12.345 
Y=ABS(-0.5) returns Y=0.5 
Y=ABS(0.5) returns Y=0.5 

or if V=-27 

Y=ABS(V) returns Y=27 
Y=ABS(V-50) returns Y=77 

Remarks 

The absolute value returned is always positive. 
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ARG 


.2.2 Function ARG Is used for passing parameters to machine code subroutines. 

Syntax D=ARG(N) 

Where D is a Dummy Variable 

N is the number to be passed 


Examples P=ARG(10) Passes 10 
P=ARG(V) Passes V 


Remarks ARG loads the Z80 E and C registers. 

They are loaded with the higher and lower byte portions of 
a 16 bit representation of the ARG argument. 

For example if V in the example above was 4100 then; 


Erl 6 Cr4 

NOTE: ^6x25M = 4100 

This function is useful when making CP/M system calls to 
set the C register before a call to location 5. See 
section 4.8, MACHINE CODE CALLS. 
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5.2.3 


ASC 


Rjnction A^ returns the decimal ASCII value of the first character 
variable. For a list of ASCII codes used with 
HUNTER Basic see section 9.2. 


SynUx ASC( "STRING") 


Examples YrASC(X$(3)) 

PRINT ASC("A") 

will print 65 

10 T$r"AB" 

20 PRINT ASC(T$) 

will also print 65, since "A" is the first character. 


Remarks The string argument must be enclosed in parentheses. 

ASC is particularly useful for detecting special characters 
like control codes, and/or distinguishing them from digits 
0-9 or characters A-Z. 
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ATN 


5.2.*I Function *™ ^«erates the angle whose tangent is specified by the 

Syntax ATN(N) 

Exaoples A=ATN(0.6009) 

Sets A equal to 0.5^11071 Radians, i.e. 31° 
or 

BsATN(V) 

sets B equal to ARCTAN of variable V 

Hemarks The resultant angle is specified in radians. 

To convert to degrees: 

A=ATN(V)«180/PI 

in the example above, 

PRINT (ATN(0.6009)*360/(2*PD) 
returns 

31.0011 
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BASIC FUNCTIONS 


SECTION 5.3 


BEEP 


.3.1 Function BEEP sounds the internal sound generator. 
Syntax BEEP 

Exanple 10 FOR I = 1 TO 100 
20 BEEP: NEXT I 


Remarks This function is equivalent to OPCHR 7 and produces a short 
tone from the sound generator. For a more varied sound use 
SOUND. 
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basic functions 


SECTION 5.^ 


CALL 


.y.1 F\inction CALL allows a machine code subroutine or an existing 
routine in HUfJTER's housekeeping package to be called from 
Basic and executed. 


Syntax D=CAIL(N) 

where D is a variable 

N is a Call Address 


Examples 10 A=CALL(0) 

20 B=CALL(V) where V is the address to be called 

Switches execution to the program located at the location 
specified. The call in line 10 causes a restart of the 
HUNTER'S software. 


Remarks WARNING: Use CALL only as indicated in section 4.8, MACHINE 
CODE CALLS. Use of unspecified calls will crash HUNTER, 
resulting in loss of data, etc. 

When control has passed back to Basic from a machine code 
program, then D = the final number stored in the Z80 
accumulator when the program returns. 
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BASIC FUNCnONS 


SECTION 5.4 


CHAR 



5.4.2 Function CHAR specifies the character set. 

Syntax CHAR n[,I] 0<n<4 

Examples CHAR 2,1 

This will output double width text in inverse video if I>0. 

Remarks In graphics mode only there are five different character 
sets, with CHAR 0 being the default set. 

I is the inverse parameter. If it is zero then the 
characters are normal. If it is non zero then inverse video 
is displayed. 


produces a small 7x5 pixel character set 
defaulted to after a SCREEN 1 statement. 

is the standard 9x7 character set. 

are double width characters. 

are double height characters. 

are double height and double width characters. 


N.B. Each time character size is changed, the cursor is 
re-located to the upper left-hand comer. 





BASIC FUNCTIC3NS 


SECTION 5.^ 


CHR$ 


5.4.3 Function CHR$ performs the inverse of ASC. It returns the single 
character string specified by the value of N, which may be 
an expression. 


Syntax CHR$(N) 

where the result of N is between 0 and 255. 


Examples 10 DIM A$f10, 10) 

20 A$ = CHR$(34):REM (see note below) 

30 PRINT "HE SAID, ":A$; "HELLO" ;A$ 

40 B=7 

50 PRIW CHR$(B):REM BEEP 

60 PRINT CHR$(1):REM THIS CLEARS THE SCREEN 

The above will print: 

HE SAID, "HELLO" 

then bleep, and then clear the screen. 


Remarks 

NOTE: 


The expression must have the value 0 to 255 
expression must be enclosed in parentheses. 


The 


(The character " cannot be 
it acts as a delimiter). 


embedded in PRINT strings since 
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SECTION 5.4 


CIRCLE 


5.4.4 Function CIRCLE draws a circle of given radius at the specified co- 
ordinates. 


Syntax CIRCLE C(X,Y,)] ,r[,n] 0a<239 

0<Y<63 


Example 10 FOR I = 20 TO 220 STEP 40 
20 CIRCLE (1,32), 20 
30 NEXT 


Will plot six circles across the display. 


Remarks The optional parameter n will plot the circle in black if 
it is odd, or erase the points if it is even. When 
omitted, it defaults to odd. The co-ordinates may also be 
omitted, and the circle is then centred on the current 
graphic cursor position. Circles plotted off the edge of 
the screen will produce wrap around. Modulo 256. 

The CIRCLE command range checks the x-coordinate, y- 
coordinate and radius to be less than 256. Since the 
HU^r^ER screen in graphics mode can only display 0-239 and 
0-63 in the x and y directions respectively, there are 
occasions when the expected circle does not appear on the 
screen. 
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BASIC FUNCTIONS 


SECnON 5.^ 


n.5 Function 

CLEAR will set all variables defined in the applications 
program to zero. 

Syntax 

CLFJ1R 

Examples 

CLEAR 

resets all variables. 

Remarks 

Note that the variables are also set to zero if at any time 
program lines are altered or added. Variable contents are 
otherwise maintained indefinitely by HUNTER, as described 
earlier. Clear also resets the FOR/NEXT loop stack and 
arithmetic stack. 
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BASIC FUNCTIONS 


SECTION 5.n 


5.n.6 Function 

CLOSE# will close any file that has been OPENed. 

Syntax 

CLDSE[#file 1,#file 2, #flle X] 

Examples 

CL0SE#n,#5 

Will close file numbers 4 and 5. 

Remarks 

If CLOSE is specified with no parameters all files that 
have been OPENed are CLOSEd. 

When the CLOSE command is executed, HUNTER'S firmware 
automatically performs a checksum generation on the file 
and stores the value in the file directory for checking the 
next time the file is opened. 

Failure to CLOSE the file in the correct manner will result 
in a 'no file' error message when an attempt is made to 
OPEN the file at a later date. 

When a file is closed, any data in the buffer not already 
written to the file will be saved. This means that there 
must be space available in the HUNTER for a file to be 
closed correctly. It is therefore recommended that the 
following method be used to ensure data integrity in all 
application programs where the above problem may arise. 

10 OPEN "EXPAN. DTA"F0R OUTPUT AS 1 
20 WRITE ##1,A:CL0SE 

This reserves an area of memory in the disk space. Using 
ONERROR to trap a "disk full" error, the handling routine 
could simply be: 

1000 KILL"EXPAN.DTA" 

1010 CLOSE 

This ensures that there will always be enough room to close 
all files. 
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BASIC FUNCTIONS 


SECTION 5.^ 


CLS 


5,^.7 Function CLS clears the display screen. 


Syntax 

CLS 

Example 

100 CLS 

This clears the screen ready for text or graphics output. 

Remarks 

In either graphics or text mode, CLS will clear the LCD 
display. It has a similar effect to OPCHR 1. In graphics 
mode, the screen may also be cleared ( and the character 
set initialised to CHAR 0) with SCREEN 1. 

NOTE: Only the screen mode currently in use (text or 
graphics) is cleared when CLS is used. 


VER.V09F 


page 5-16 


basic functions 


SECTION 5.‘i 


COM 


^.8 Function 

COM activates or deactivates the communications interrupt 
routine. 

Syntax 

COM ON 
COM OFF 
COM STOP 

These statements must be initialised with an ON COM 
statement. 

Example 

10 ON COM GOSUB 1000 
20 COM ON 

1000 REM TRAP ROUTINE 
1010 LINPUT A$ ... 

1990 RETURN 

Remarks 

These statements decide what action is taken on receiving 
communications. The interrupt occurs on the first 
character. 

COM ON When executed, allows trapping of communications 

by the ON COM statement. If the previous state 
was COM OFF then the buffer is cleared by this 
statement. 

COM OFF The trapping is deactivated and all 
communications interrupts are ignored. 


COM STOP Comnnjnications interrupts are noted but not acted 
upon by the ON COM statement until a COM ON is 
executed. 
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BASIC FUNCTIONS 


SECnON 5.^ 


CONT 


Ranction CONT continues Basic program aft^r STOP. 


Syntax CONT [Line number] 

'Line number' is optional and allows the program to 
continue from a different line number. 


Exanples CONT ccMitinue from next line 
or 

CONT 1000 continue from line 1000 


Remarks Allows a program to continue execution from the line 
following the occurrence of: 

a) detection of the break key 

b) execution of a 'STOP' statement 

c) execution of an 'END' statement 

d) detection of a syntax error 


® argument continuation can occur 

from that line number. 

In the case of multiple statement lines, execution will 
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BASIC FUNCnONS 


SECTION 5.^ 


5.^. 10 Function 

COS returns the Cosine of the argument. 

Syntax 

COS (Angle) 

Where angle is in radians. 

Examples 

X = COS(Y) sets X equal to the cosine of Y. 

R = C0S(5) sets R equal to the cosine of 5 radians. 

Remarks 

NOTE: For angles in degrees use: 
XrCOS(A/l80»PI) 
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BASIC FUNCTIONS 


SECTION 5. 'I 


CRT 


5.4.11 Function CRT causes HUNTER to treat the serial port as the display 
and keyboard rather than the internal LCD display and 
keyboard. 


Syntax CRT 
Examples CRT 


Renarks CRT sets keyboard and display functions to the RS-232 port. 

The command is useful for entering programs quickly also 
characters not on HUNTER'S keyboard may be used. 

Any standard VDU may be used. Baud rates and other 
parameters are set on HUNTER using 'Initialise 
Connwnications ' . 

Remember that a 'crossed' RS-232 lead is needed with 
GNDjRXD and TXD circuits installed. 
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BASIC FUNCTIONS 


SECTION 5.4 


5.4.12 Function 

CUROFF/CURON turns cursor off and on. 

Syntax 

CUROFF 

CURON 

Example 

CUROFF 

To remove the cursor when display in use. 
CURON 

This will turn the cursor on. 

Remarks 

HUNTTER defalts to CURON following power up. 
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BASIC FUNCTIONS 


SECTION 5.5 


DATA 


5.5.1 


Function 


DATA statements hold constants for use in subsequent READ 
statements. 


syntax DATA item 1, item 2 item n. 


Examples DSTA 1?.A1,25,SI«I(0.5),MID$(A$,3.4),99 
110 DATA 5,6,7,8,6«5,”HEUjO" 

“ill take 5, and so on, 
until every data value Is used. This form of data storaee 

era™ var*i^b^s*’'' P™*'"®"' line changes which wUl 

list use the RESTORE°stetement.° ® 

it'^^^Vot^^^or-p^rrif^ r:?t-;pTe\?a7s.“"* 


Remark 


The arguments for DATA statements 
values, variables, or expressions, 
separated by commas. 


can be either numerical 
Multiple arguments are 


t«t mist he .n^? "I'' Statements, 

t-ext must be enclosed in quotes. 


NOTE: Care 
corresponding 
DATA. 


iiiuoL oe taken 


read statement are of the same t^e L iht 
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SECTION 5.5 


5.2 Function 

DATES returns a ten character string including the day, 
month and year separated by dashes. It may be used both as 
a statement and a variable. 

Syntax 

A$ = DATES or DATES = BS 

Exanple 

10 DATES = '*5/1 2/86” 
20 PRINT DATES 

Remarks 

The ten character string returned by DATES is in the format 
MM-DD-YYYY. As in the example, when DATES is used as a 
variable leading zeros may be omitted and the year 
defaulted to 19yy. 

DATES will accept /or : or - delimiters to set the date, 
but will always print the date using -. 
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BASIC FUNCnONS 


SECTION 5.5 


DAY$ 


5.5.3 Function DATS returns a three character string, it may also be used 
for setting the correct day. 

SynUx DAYS [="MON'»] 

Examples DAI$="MON" 

will set DAYS to MON 
100 PRINT DAYS 
will output: 

Mon 


Remarks The day string may be input in upper or lower case. 

Acceptable days are: 

MON 

TUE 

WED 

THU 

FRI 

SAT 

SUN 


DAYS always outputs the day with one upper case 
and two lower case. 


character 
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BASIC FUNCnONS 


SECTIOfi 5.5 


DEFSEG 




5.5.4 Function DEFSEG defines the page of RAM addressed by subsequent 
CALL, PEEK or POKE commands. 

Syntax DEFSEG = page no. 

Example DEFSEG=1 

sets RAM page to 1 

DEFSEG ray also be used as part of an expression 
PKIIT DEFSEG»3 

Remarks Page no. is an expression from 0 to the last page in the 
system. When HUNTER is powered up, DEFSEG is set to 0. 
This is the TPA or workspace, most often used for machine 
code programs called from Basic. 

After a program error, DEFSEG is set back to 0. 
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BASIC FUNCnONS 


SECTION 5.5 


DIM 


5.5.6 Function DIM allocates arrays within HUNTER. 

Syntax DIM variable name (array size) 

DIM double precision variable name (array size) 

DIM string variable name (array size, element size) 
where array size and element size are numeric expressions. 

Examples DIM A (25) 

defines an array variable A of 26 elements, including the 
element A(0). The array size must be positive. 

DIM Ji4(100),J5(100),Q(1000),J(N) 

defines multiple arrays. N is a previously defined variable. 


Remarks There are three kinds of DIM statement in HUNTER Basic : 
Simple variables, double precision variables and strings. 

NOTE: The maximum number of elements in a single array is 
16,38^1. 

All array types have a range from 0 (zero) to the limit 
defined in the DIM statement. 

Arrays can be allocated to any combination of variable 
names . 

Double precision arrays are defined in the same way except 
for the use of ”!”. Each element has a 14-digit size. 

DIM A!(25) 

DIM AZK32) 

define double precision arrays. 

Space for string arrays is reserved in HUNTER memory using 
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BASIC FUNCnONS 


SECnON 5.5 


a DIM statement followed by string name, the number of 
elements in the array, and the maximum string length 
required. 

DIM A$(25,10) 


defines a string array with 25 elements each of maximum 
length of 10 characters. 

Each character in a string requires 1 byte of storage. 

Since HU^r^ER retains variable definitions indefinitely, DIM 
statements should not be included in normal user program 
sequences. Instead, arrays should be initialised by a 
separate routine or defined directly i.e. without line 


application software a 
switch indicating whether the program is being used for the 
first time or not. If the switch is a variable which is 

the fact that 

^y modifications or use of the CLEAR statement will clear 

to determine whether the 
arrays should be redefined or not. 


10 If A = 1 THEN GO TO 100 
20 DIM J(50) 


90 A = 1 

100 REM user program starts here. 


NOTE: That the variable A could 
indicate the number of times that 


be used as a counter to 
the program has been run. 


Default values for numeric arrays are 10 elements «?i-rincTo 
default to one element of 20 character's v 

have to be dimensioned. “naraoters, larger strings 
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SECTION 5.6 


EDIT 


5.6.1 Function EDIT invokes the Hunter text editor. 


Syntax EDIT [filename] 


Examples EDIT 

The editor is invoked. If a Basic program is currently 
loaded in the workspace, the ^Itor will operate on it. If 
no program is loaded, entry of new text or program may 
proceed. 

EDIT "PROGI" 

Program PROG1.HBA is first loaded into the workspace. EDIT 
is then invoked. 


Remarks For full description of the editor see section 7, EDITOR. 

EDIT cannot be used as a program statement. 

To exit EDIT, either save the file (CTL/FN 6, followed by 
filename) or Exit (CTL/FN 8). The edited version of the 
program will remain in the workspace. 

NOTE: Following 'Save' or 'Exit' commands, the editor will 

display a message: 

»* Wait 

A few seconds may elapse while the editor re-tokenises the 
Basic source text into the more compact format of the MBA 
file. 

Only files with the .HBA suffix are treated in this way. 
When invoked from Basic, the editor assumes .HBA as a 
default suffix. 
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BASIC FUNCTIONS 


SECTION 5.6 


END 


5.6.2 Function EM) terminates user program execution. 

Syntax END 

Examples 100C END 

when executed, displays: 

READY 

and returns control to the Basic command level. 


Remarks END does not require an argument. 

This is normally the last line of a program although Basic 
will default an END even if it does not exist. END may 
also be used Ir the middle of programs for terminating it. 

Generally user programs do not END but retain control over 
HIJOTER operation. 
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BASIC FUNCTIONS 


SECTION 5.6 


EOF 


5.6.3 Function EOF checks for end of file. 
Syntax E0F(file no) 


Exanples 10 OPEN ’'DATA. TXT" FOR INPUT AS #1 
20 INPUT#1,A,B,C 
30 PRI^r^ A,B,C 

40 IF E0F(1)THEN CLOSE #1 ELSE GOTO 20 
50 PRINT"END OF FILE":END 


Remarks E(F = -1 if end of file has been reached 
EOF = 0 if more data is in the file 

Programs should not try to read beyond the end of a file 
since an error will occur. 

NOTE: The file DATA.TXT used in this example, could be 

created by a Basic program of the form: 

100 OPEN "DATA.TXT"F0R OUTPUT AS #1 
110 WRITE#1, 123,235,345 
120 CL0SE#1 
130 END 

This will ensure that the correct end of file marker is 
written to the file. 
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BASIC FUNCTIONS 


SECTION 5.6 


ERR/ERL 


5.6.y Function ERR and ERL return the error code and the line number at 
which the error occurred respectively. 


Syntax X = ERR Y = ERL 


Example 

10 GOTO 50 
20 A = ERR 

30 PRIffT "Error Number";A;"at line";ERL 
50 ON ERROR GOTO 20 
60 B=A/0 
70 STOP 

This example prints: 

Error Number 6 at line 60 

due to the floating point error caused by an attempt to 
divide by zero. 


Remarks ERR and ERL will always contain the codes of the last 
error, and will often be used in conjunction with ERROR. 

These functions are often used in communications with the 
ON ERROR GOTO trap. 

NOTE: See section ^.14 for actual error numbers. 

ERR defaults to zero until an error occurs. 
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BASIC FUNCTIONS 


SECTION 5.6 


ERROR 


5.6.5 Function ERROR simulates a Basic error with the advantage that it 
allows user defined codes. For a list of Bsic error 
messages, see section M.1^1. 


Syntax ERROR n 

where 0<n<255 


Example 10 INPUTa,b 

20 ONERRORGOT0100 
30 IFa>bTHENERROR156 
40 GOT010 

100 IFERR = 156THENPRIhrr"a>b error" 

110 RESUME 10 

Remarks The ERROR statement neatly traps errors and forces the 
printing of a Basic error message. If the error number is 
undefined in Basic, then processing can be forced to 
restart at another line to print a user defined message. 
When ERROR is set to n, this number may be recovered with 
ERR, and the line number with ERL 

After a forced user error trap, a suitable RESUME command 
must be executed to ensure correct program operation. 
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SECnON 5.6 


EXP 


5.6.6 Function EXP generates the value of e raised to the power of X. 

Syntax EXP(X) 

Examples A!(0)zEXP(3) 

(A!(0)=e to the third power) 

BrEXP(N) 

(B=e to the power of N) 

Remarks X must be in the range -290 to +290. 

If X is not in this range then a ’MAG Error' will occur. 
X may be an expression, 
e is defined as: 2.718281828^1590 
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BASIC FUNCTIONS 


SECTION 5.7 


5.7.1 Function 

FILES displays all the current user files in HUNTER. 

Syntax 

FILES 

Exanple 

This program will list all the current user files in 
HUNTER: 

6030 CLS:PRI NT ’’Please enter the file you wish to select:" 
60M0 LOCATEO, 1 : PRINT" (Use shift arrow keys to scroll)" 

6050 LOCATEO, 3 :FILES 

6060 LOCATEO, 2:INPIJT"enter filename ";a$ 
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BASIC FUNCTIONS 


SECTION 5.7 


FIX 


5.7.2 Function FIX reduces the argument to an integer. 


Syntax A=FIX(n) 


Examples A=FIXC12.37) 
sets A = 12 

A=FIX(-5.95) 
sets A=-5 


Remarks FIX should not be confused with INT which will round 
negative numbers. 
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SECTION 5.7 


FOR 


5.7.3 Function FOR executes a series of instructions in a loop a given 
number of times. 


Syntax FOR N = A TO B STEP C 
NED(T N 

Where N is a variable, A is a numeric start value, B is a 
numeric end value and C is an increment/decrement value. 

A, B and C can be numbers, variables or expressions. 
Examples 10 FOR A = 1 TO 100 STEP 10 


100 NEXT A 

causes the value of A to equal 1,11,21 etc., for each 
execution of the loop. 

To obtain a decrementing count negative values of STEP are 
used. 

1000 FOR Z1=91 TO 10 STEP -.1 


1050 NEXT Z1 


Remarks 


When followed by a NEXT statement, FOR will execute the 
intervening parameters for the number of times indicated by 
the values A and B divided by N to the formula: 


(B-A+2)/N 

When terminating F0R...NEXT loops it is important to end 
using NEXT and not GOTO. Alternatively, exiting via a 
RETURN when in a subroutine will not cause a build up of 
the 'control stack'. 

Failure to do this will result in a control stack error. 
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SECTION 5.7 


FRE 


5.7.^ Function FRE returns the number of free bytes left in execution 
memory (RO). 


Syntax FRE(O) 

0 is a dummy argument. 

Examples PRINT FRE(O) 

displays amount of free space in execution memory, 
or 

A=FPE(0) 

•Sets A = amount of free space. 


Remarks Note that if a program has not been RUN then the variables 
will not have been assigned space. This enables easy 
dj. splay of program size and, after RUNine, the total memory 
usage. 

The latter examples allows the AUTO SIZING of arrays to 
their maximum size. 


e.g. DIM A((FRE(0)-102il0)/5) 

This autoslzes A leaving 10K (10?«0 byte) for other 
variables. "5« is the number of bytes used for each member 
or A. Remember to leave enough space for all simple 
variables. 
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SECTION 5.8 


GOSUB 


5.8.1 Function GOSUB causes execution to jump to a Basic subroutine 
located elsewhere in the applications program. 


Syntax GOSUB line number 

GOSUB numeric expression 


Exanples GOSUB 150 


causes program execution to jump to a subroutine located at 
150. 

The argument can also be an argument or expression, for 
exanple: 

GOSUB SI 


GOSUB SI+100*A 


This is illustrated by the program sequence: 

10 INPUT A 
20 SI=1000 
30 GOSUB SI+100*A 
40 STOP 

1000 PRINT •THES IS SUBROUHNE 1" 

1010 RETURN 

1100 PRINT "THIS IS SUBROUTINE 2" 

1110 RETURN 
etc. 

If the number 0 is entered in line 10, the program will 
perform subroutine 1. Input of the number 1 will cause 
subroutine 2 to be executed. 
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A subroutine must always be terminated by a 'RETURN' state 
ment. Program execution then continues from the statement 
immediately after the GOSUB. GOSUB always requires a line 
number as an argument. 
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SECnON 5.8 


GOTO 


5.8.2 Function GOTO branches unconditionally to a specified line number. 

Syntax GOTO line number 

GOTO numeric expression 


Examples GOTO 50 

causes program execution to commence immediately at line 
50. 

10 GOTO 100 

causes program execution to skip from line 10 to line 100. 

The line number may also be a variable or an expression. 
Exanples: 

GOTO A or GOTO A»100 

are equally valid. 

The program sequence: 

20 ZB=150 
30 GOTO ZB 

150 PRINT "THIS IS LINE"; ZB 
would give: THIS IS LINE 150 


Remarks 


GOTO is always used with an argument (line number). If 
used as an immediate command, GOTO will cause program 
execution to commence from the line number specified. If 
used as part of a program, GOTO will cause program 
execution to skip to the line number specified. If the 
line specified is not present in memory HUNTER will 
uxspxdy • 

«LNo Error in line 150» 

If the GOTO line was unnumbered, the error message line 
number will be meaningless. 
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SECTION 5.9 


5.9.1 Function 


Syntax 


Examples 


Remarks 


HELP 


HELP displays lines of text on HUNTER'S screen when the 
HELP key is pressed. 


HELP line number 
HELP numeric expression 


1010 REM ms IS A PIECE OF HELP TEXT 
1020 REM INTENDED TO ASSIST THE OPERATOR 
1030 REM IN THE USE OF HUNTER 
1040 REM PLEASE PRESS HELP TO RETURN 
1050 REM TO PROGRAM 

10000 HELP 1010 

Execution of line 10000 will cause the block of remarks to 
be used as the HELP text. 

HELP requires an argument which must be a valid line 
number. The referenced line must be a REM statement. When 
the operator presses HELP, text from the referenced REM is 
placed on the screen. Use of the cursor up and cursor 
down keys causes scrolling through a contiguous block of 
REM statements. The HELP text start may be changed by 
executing another HELP statement. 

Normally, the help key on the HUNTER keyboard is disabled. 
Execution of HELP causes the HELP code to be loaded into 
the keyboard table, therefore enabling the use of the key. 
Once the HELP statement has been executed, it is not 
possible to disable the HELP function except for deleting 
the HELP code in the keyboard map. 

NOTE: On power up the help key will be again disabled and 
therefore it is necessary to execute the HELP statement 
within the program initialisation. 

It is recommended that all the HELP text be written con- 
tiguously so that the operator may scroll through all of 
it. Scrolling stops when any non-REM line is encountered, 
so blocks of text can be easily partitioned if required. 

NOTE: HELP text cannot be displayed if HUNTER is in 
graphics mode and operation of the HELP key is ignored. It 
is then necessary to use "shift PWR" to turn off HUNTER. 
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SECnON 5.10 


IF 


5.10,1 Function IF selectively executes program statements dependant on 
result of an expression. 


Syntax IF A(op)B THEN C 

Where A is an expression, variable or constant and (op) is 
an operator =, < , > etc. The operator may be logical or 
omitted. See section 4.2.3, LOGICAL OPERATIONS, for 
further details. 

B is an expression, variable or constant 
C is either a line number or program statement. 


Exanples IF A = B THEN 100 

IF A>B THEN PRINT »'N0” 


C may be a multiple statement which will be entirely 
executed if the condition is true, but skipped if not. 

HUNTER also permits nesting of IF statements. 

Example: 

IF A= B TWEN IF C=D THEN PRINT •T’INISHED»':G0T0 1000 

String expressions may be tested for equality or 
unequality, for example: 

IF A$ + B$ = "ABCDEAB" THEN 100 

or 


IF A=B AND B=C OR D=5 THEN PRINT "TRUE" 


In this example "TRUE" may be printed by one of two methods 
allowed by the OR operator as follows: 


1 ) if A=B=C 

2) if D=5 
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However, 

IF A=B AND B=C AND D=5 THEN PRIhrT"TRUE" 

will only print "TRUE" if all conditions are satisfied. 

IF A THEN PRINT "TRUE" 

will print "TRUE" only if the variable A is non-zero, i.e. 
if A=-19 then "TRUE" will be printed. 

See section 4.2.2, EXPRESSIONS AND OPERATORS, and 4.2.3, 
LOGICAL OPERATIONS, for precise details of logical 
operators . 


Remarks For strings of unequal length the equality will be true if 
the string on the left of the equates is equal to or part 
of the string on the right as follows: 

IF A$ = "ABC" and B$ = "ABCD" 

THEN 

A$ = B$ is true 
B$ = A$ is not true 
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5.10.2 Function 

IF. ..THEN. ..ELSE... executes either of two 
statements as the result of an expression. 

Syntax 

IF (expression) THEN (statementi) [ELSE (statement) 2] 

Examples 

IF A=B THEN X=10 ELSE A=A+1 

IF D AND NOT B THEN C=0:GOT050 ELSE RETURN 

Multiple statements separated with colons are implemented 
or skipped depending on the condition. 

IF A=6 THEN IF B>10 THEN A=0 ELSE ELSE A=A+1 

Omitting the first ELSE will move processing straight onto 
the next line if the first condition is false (fe A=6) and 
cause A to be incremented if A=6 and B>10. 

Remarks 

The expression must be able to be evaluated true or false. 
If the expression is true then statement 1 is executed, and 
if false statement 2 is executed. 

The statement may include other conditional statements 
(nested), but care must be exercised in the positioning of 
ELSE to associate them with the correct IF. Generally, 
each ELSE is associated with the most recent IF. Extra 
ELSE statements causing no action at the end of the line 
may be omitted. 

The use of logical operators outlined in the section 
relating to 'IF' are also allowed when using 
IF... THEN... ELSE. 
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5.10.3 


INCHR 


Function INCHR inputs a single character from the keyboard. 


Syntax INCHR variable name 

INCHRC'PROMT STRING";] variable name 


Exanples 10 INCHR "DECIMAL VALUE"; A 
20 PRIfTT A 
30 GOTO 10 

displays: 

DECIMAL VALUE ?A 65 
DECIMAL VALUE ?B 66 
etc. 


Remarks INCHR does not wait for ENTER to be pressed. A prompt 
message is displayed as with INPUT. Only one variable may 
be entered. The variable is set to the decimal value of the 
character, as detailed in section 9.2, ASCII CHARACTER SET. 

A comma following INCHR or the prompt message will suppress 
the prompt character '?' The comma replaces the semicolon 
in the syntax. 

NOTE: No values are returned for SHIFT, HELP, CONTROL or 
POWER keys, although these function normally during INCHR. 

•Escape’ cannot be used to return to Basic from an INCHR 
loop, since it simply returns the value 27! 
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INKEY 


5. 10.^4 Function INKEY checks the keyboard for the operation of a key. 

Syntax INKEY A 

Examples INKEY A = 65 THEN STOP 

detects capital A and stops. 

Remarks The variable A is attributed the value of the key pressed. 

If no key is detected then the variable is equal to zero. 

INKEY does not wait for a key to be pressed; execution 
continues inmediately at the next statement. 

INKEY is the faster method for obtaining the keyboard 
status. 
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5.10.5 Function 

INKEY$ reads the keyboard and returns a single character if 
an input Is pending on the keyboard. 

Syntax 

A$ = TNKEY$ 

Exanple 

10 A$ = INKEY$ 

?0 IF A$ = THEN 40 

30 PRim* A$ 

40 GOTO 10 

Remarks 

If a key has not been pressed then a null string is 
returned. The ASCII code of each key, including control 
codes, is read and assigned to the one character string 
variable A$. 

The characters entered into the program in this manner are 
not displayed on the screen unless explicitly printed (line 
30 in the example). One application may be to insert a 
pause in a program before displaying another screen of 
information: 

80 PRIW'last line of last screen" 

90 A$=INKEY$: IF A$="" then 90 
100 PRTWFirst line of next screen" 

If a function key is pressed then a two character string is 
returned consisting of the character and the number of 
the key pressed i.e. Pressing Function Key 1 will return 
the string "'‘1" to an INKEY $ function. 
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INP 


5.10.6 Function INP inputs a byte from the designated port. 


Syntax INP (PORT) 

where PORT is a numeric Port Number. 


Examples A = INP(132) 


Remarks Refer to section 9.8, PORT ALLOCATIONS, for details of 
addresses and functions. 

NOTE: A 'port' is a term used at the hardware level of 
Hunter. It refers to the input/output addresses used by 
the NSC800. 
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5.10.7 


INPUT 


Function INPUT obtains a line of data from HUNTER'S keyboard 
Syntax INPUT[; ] ["prompt string";] varl, var2, ...var n 

Examples INPUT A 

Inputs a numeric value from the keyboard and places it into 
the variable A. 

INPUT"Parameters";A,B,C$ 

Inputs the values of A, B, C$ with the prompt message: 
Parameters? 


A comma following the prompt string supresses the question 
mark prompt following the pronpt string: 

INPUr"Parame ters" , A ,B , C$ 

will prompt: 

Parameters 

If no prompt message is required at all then the format 
entered is: 

INPLrr"",A 

A semicolon prior to the prompt string will inhibit the 
echo of the users 'Carriage Return'. 

Remarks Note that input lines are always terminated by press inc the 
'ENTER' key. ^ ^ ® 

INPin* cannot be used as a direct statement. 
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NOTE: 


If INPUT'S argument is a simple variable and an 
invalid entry is made, INPUT will simply re-prompt 
without an error message. An example is: 


10 INPUT A 

The user types 'HELLO'. After 'ENTER', HUNTER re-prompts 
on the next line: 

? re-do from start 
? 

and awaits a numerical entry. 
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5.10.8 Function INPUT USING obtains a line of data from HUNTER'S keyboard 
and validates this data with a user defined mask. 


Syntax INPUT USING (validation string, [min, maxi) prompt string, 
variable name. 

INPUT USING (validation string, [min, max, E]) variable name 
where min, max are numeric expressions and E is a special 
command. 


Exanples INPUT USING ("A999",2,4)S$ 

Causes ? prompt 

A minimum of 2 characters must be entered up to a maximum 
of 4. 

The inputs are stored in string expression S$. The first 
entry must be a letter in the range A-Z, the remaining 
entries must be numbers in the range 0-9. 

INPUT USING CA999",,4)S$ 

The same as above, but minimum defaults to 1. 

INPUT USING ("A999",2,)S$ 

A minimum entry of 2 and maximum defaults to 95. Any 
entries after the fourth are validated against WILD. 

INPUT USING CA999")S$ 

Minimum and maximum default to 1 and 95 respectively. 

INPUT USING (M$,3,6)S$ 

A minimum of 3 and up to a maximum of 6 entries are 
allowed. The entries are validated against the string 
expression M$. The user will receive a '?' prompt. 
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INPUT USING (M$,3,6)»'ENTER",S$ 

Same as above, but with an 'EWTER' prompt. 

INPUT USING (M$,3,6,E)»ENTER»,S$ 

Same as above, but after the 6th character has been entered 
HUNTER will assume that the enter key has been pressed. 

Remarks Entry fields can be made numeric, alphanumeric, etc., in 
flexible configurations. Entries that do not fit the mask 
are rejected with a bleep. 

INPUT USING is an extension of the standard INPUT state- 
ment. However, as each entry is made by the operator, the 
character is checked against the defined check string. A 
value which is out of range will cause an audible bleep to 
occur, rejecting the invalid entry. 

The input validation string consists of defined validation 
characters either in the form of a string expression e.g. 
A$,B^I$ etc., or a direct string enclosed in quotations. 
Input validation string may NOT be omitted. 

The optional min and max expressions define the minimum 
number and maximum number of entries required. If neither 
min nor max are specified then default values of min 1 and 
max 95 are assumed. If maximum exceeds the number of 
characters in the input validation string, then the entries 
for which there are no validation characters are validated 
automatically with WILD card characters. If min=0 an input 
of 'CR* only is allowed. 


The values min and max can be variables or arithmetic 
expressions. Min must not exceed max or a syntax error will 
occur. Min must not be negative or a magnitude error will 
occur. Min and max must not exceed 95 or a syntax error 
will occur. 


’Enter’ terminates entry. ’ Enter’ will not be 
the number of characters is less than minimum. 


accepted if 
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When the number of characters exceeds maximum no more 
characters will be accepted. A warning tone will sound. 
The cursor right and cursor left are available in INPUT 
USING fields to edit or correct data prior to pressing 
•EWTER’. 

The E parameter is optional. If it is specified then the 
’Enter' key does not have to be pressed to terminate the 
end of the characters allowed by the validation mask. 

CAUTION: If the input field extends over more than one 
HUNTER screen line confusing results may occur in subsequent 
attempts to delete or edit characters. 

To suppress the "?" prompt, a comma should follow the 
prompt string. There must be a prompt string when using 
comma, therefore, to have no prompt at all it is necessary 
to use the null string 

A string, enclosed by quotes, immediately following the 
validation expression will cause that string to act as the 
prompt. 

The cursor left and right keys are enabled in order to 
allow the user to modify incorrect entries by simply over- 
typing them. The delete key will delete the last character 
entered. 

VALIDATION CHARACTER TABLE 


A A-Z only 

B A-Z space 

C A-Z 0-9 

D A-Z 0-9 space 

N 0-9 , 

9 0-9 only 

. Decimal point only 

* Wildcard 


NOTE 1 : Wildcard allows a character in the range of space - del 

which includes all letters and numbers. 

NOTE 2: Control characters are not accepted. Other characters 

than those in the table will give a Syntax error when 
the statement is RUN. 
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5.10 


INPUT# 


.9 Function INPUT# reads data from file. 


Syntax INPUT#file no,var1,var2, . . . . varX 


Examples INPUT#1 ,A,B$,C$ 

This will input data to the variables A,B$ and C$ from file 


Jh! statement should match 

the type of data stored in the file. 

the checked to detect If 

exiles. ^ ^ ‘ **®®" reached. See 5.6.3. for 
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INSTR 


5.10.10 Function INSTR searches for the occurrence of one string in another, 
and returns with the position of the first match. 


Syntax Y = INSTR (CX]A$,B$) KX<255 


Example 10 A$ = "BASICS" 

20 PRINT INSTR (A$,"S") 

This program will print 3, since this is the first 
occurrence of the letter S. 

10 A$ = "SUPER BASICS" 

20 B$ = "SI" 

30 PRINT INSTR(A$,B$) 

This program will print 9 as the first occurrence of SI. 

10 A$ = "BASICS" 

20 PRINT INSTR (4,A$,"S") 

The above program will print 6, since this is the first 
occurrence of the letter S from the fourth character on- 
wards in the string A$. 

Remarks If B$ does not occur in A$, then 0 is returned. X, which 
is optional and defaults to 1, is used to start the search 
at a particular place within a string. 

Case is also important, i.e. "s" is not the same as "S". 
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INT 


5.10.11 Function INT returns the truncated value of the argument, if 
positive, or rounds the value if negative. 


Syntax IffT(N) 

Where N is a numeric expresion 


Examples A r INT( 123.^56) 

sets A equal to 123. 


Remarks NOTE: Negative numbers will be rounded in a negative 
direction. 

A=INT(-4.75) 

Sets A equal to -5 

FIX is an alternative method. 
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KEY 


5.12.1 Function KEY enables/disables display of, and redefines soft key 
values. 


Syntax KEY ON 
KEY OFF 
KEY LIST 

KEYn, string 0<=n<=8 


Example KEY ON 

Allows the soft key display to be displayed on the bottom 
line of the display. This line is then not scrolled. 

KEY OFF 

Erases the soft key display from the bottom line of the 
screen, allowing this line to be used by the user. It does 
not inhibit the use of soft keys. 

KEY LIST 

This displays the entire string assignments of the eight 
soft keys on the screen. 

KEYn, string 

The keys are programmed by writing a string, of which the 
first four characters are displayed on the bottom line of 
the screen if the soft key display has been enabled. 

KEY1,»'?X,Y»* 

will set key 1 to print the values of the variables x aid y 
when struck. Using the soft keys is equivalent to using 
the keyboard - but faster. 
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KEY 1, »?TIME$»'4CHR$(13) 

will display the time when pressing soft key 1. 


REMARKS On entering Basic, the soft keys default to: 

KEY 1: File(s) KEY 5: Save(”) 

2: Run 6; Load(”) 

3: Edit 7: KilK") 

List 8: Syst(em) 

However, if the auto-run mode on power up has been 
selected, the soft keys are left as they were last 
programmed. 

When using the KEYn, string command, if KEYO is typed the 
soft keys revert to their power up default values. If n is 
not in the required range then a 'Magnitude Error* occurs. 

If it is required to terminate the string with a carriage 
return or Enter, then it is necessary to terminate with 
"string" +CHR$(13) as control characters are not accepted 
in command lines. 
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KEY(n) 


.2 Function KEY(n) activates and terminates trapping of soft keys. 


Syntax KEY(n) ON 
KEY(n) OFF 
KEY(n) STOP 

3 ^»"eric expression in the range 1 to 8 to reference 


Exaople 10 ON KEY (1) GOSUB 1000 
20 KEY (1) ON 


900 END »FINISH OF MAIN ROUTINE 
1000 REM SOFT KEY (1) TRAP ROUTINE 
1990 RETURN 


Remarks 


The KEY(n) statement is used for tranoina i 

the line number specified In the ON KEY (n) statement! 
m\'iutemen\! altered with 

b^VngVroc«s7d,^then"!re^ntfr?^ 

Sufi: 

each individual routine cannot be ^e^lentered 
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KEY (n) OFF The trapping routine is deactivated, and the 
key press is ignored. 

KEY (n) STOP Immediate execution of the trapping routine 
does not take place, but the key is remembered and left 
pending until a KEY (n) ON statement is encountered. 
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KILL 


5.12.3 Function KILL deletes a file in RAM storage. 


Syntax KILL filename 

Example KILL '»FIRST.HBA»' 

Deletes FIRST. HBA 
KILL A$ 

Deletes the filename contained in A$ 

Remarks In order to KILL a file the filename must be given either 
explicitly or only using the »»?" wildcard. Variable names 
are accepted, but must contain actual filenames. 

NOTE: If the file does not exist, then no action is taken 
and no warning message issued. 

If wildcards are used, then all files which conform to the 
format are erased, e.g. if H.1 and H.2 exist as files, 
then: 

KILL "H.?" 

will delete both of them. 
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5.13.1 Function 

LEFT$ returns the first n characters from a designated 
string. Either string or n may be expressions. 

Syntax 

LEFT$( "STRING”, N) 

where string is a string expression N is the number of left 
most characters. 

Exaoples 

10 A$ ="ABCDEFG" 

20 B$ = LEFT$(A$,3) 
30 PRINT B$ 

prints ABC. 

Remarks 

LEFT$(A$,0) returns a Null String i.e. "" 
LEFT$(A$,50) returns ABCDEFG 

N cannot be negative or a "MAG" error will result. 
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5.13.2 Function LEN returns the length of a string. 

Syntax LEN (string) 

where string is a string expression. 


Examples 10 A$ = "ABCDEFC” 
20 PRINT LEN (A$) 

prints 7. 


Renarks The string may be an expression. 
A null string has zero length. 




5.13.3 Function LET assigns a value to a variable. 

Syntax LET variable name = numerical expression 
LET string variable = string expression 


Examples LET C = 5 
LET D3 = B 
LET J = SIN(X) 

LET A$ = "HELLO" 

LET A$ = B$ (see note) 

Use of LET in an assignment statement is optional. The 
formats: 

C = 5 
D3 = B 
J = SIN(X) 

A$ = "HELLO" 

A$ = B$ (see notes below) 


"5 


are equally acceptable. 


Remarks NOTE: When equating string arrays of unequal length the 
string array on the right side of the equates will be 
truncated on the left side. 

Example: 

DIM A$(1,5) 

A$ = "HELLO" 

B$ = "GOODBYE" 

A$ = B$ 

then A$ = "GOODB" 

NOTE: Remember that string lengths default to 20 
characters. In the above example, A$ should be DIMed to 5 
character length as shown. 

Strings can be created by multiple additions. 

Example: 


A$ = A$ + MID$(C$,4,3)+CHR$(65) 
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StririK expressions can also be created from complex string 
expressions of up to 10 functions. The derivation of the 
function requires the creation of an expression stack which 
can handle a maximum of ten functions. If the stack is 
excecUecl a 'string complexity' error will result. 

Example: 

A$ = LEFT$(RIGHT$(MID$CA$,3,N),A),B) 
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LINCHR 


5.13.^ Function LINCHR inputs a single character from the RS-232 port. 


Syntax LINCHR variable name 

LINCHR ["PROMPT STRING";] VARIABLE NAME 


Examples 10 LINCHR "DECIMAL VALUE", A 
20 PRIhTT A 
30 GOTO 10 

displays: 

DECIMAL VALUE 65 
DECIMAL VALUE 66 
etc. 


Remarks LINCHR does not wait for carriage return to be received and 
the character input is not echoed to the screen. A prompt 
message is displayed on the LCD screen as with INPUT. Only 
one variable will be received. The variable is set to the 
decimal value of the character, as detailed in section 9.2, 
ASCII CHARACTER SET. 

A comma following the prompt message will supress the 
prompt character '?'. 

Characters input from the serial port are not echoed onto 
the screen. 
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5.13.5 Function LINE draws lines and boxes on the graphics screen. 

Syntax Line [(XI, ID) - (X2.y2)[.P[,B[F))l 0<X<239 

0<Y<63 

Examples 10 LINE (10, 10) - (50,60) 

Draws a line from the co-ordinates (10,10) to (50,60) 


The F parameter is used to mi ..u ^ 

specified colour P. The P oaramiV ^ ^he 

either the B or BF is used^ ThT specified if 
nil the graphics screen with a black nUed® ln°Sox7‘‘ 


LINE(0,0)-(239,63),1,BF 
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LINPUT 


5.13.6 Function LINPUT obtains a line of data from HUNTER'S RS-232 port. 


Syntax LINPUT [;]["prompt string";] variable name 
Examples LINPUT A 

Inputs from the serial port a numeric value and places it 
in variable A. 

LINPUT "PARAMETER VALUES" A,B,C 

Input the values of A, B and C with the prompt message: 

PARAMETER VALUES 
? 


Remarks Note that input lines are always terminated on reception of 
a carriage return (CR) character. 

LINPUT cannot be used as a direct statement. 

A prompt message can be displayed by the LINPUT statement. 
A string variable name or a literal string is required as 
an argument. Multiple variables can be strung together, 
separated by commas. 

The characters input from the serial input port are NOT 
echoed to the screen. 

A comma following the prompt message will suppress 
LINPUT's '?' prompt. 

NOTE: If LINPUT's argument is a simple variable and an 
invalid entry is made, LINPUT will simply re-prompt without 
an error message. An example is: 

10 LINPUT A 

HUNTER receives 'HELLO'. After 'CR', LINPUT generates a 
loud 'bleep' and re-prompts on the next line. 

NOTE: While the HUNTER is waiting for the first character 
to be received from the port, it will 'bleep' at 30 second 
intervals. 
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5 . 13.7 Function LIST causes HUNTER to list the program on the LCD screen. 


Syntax LIST [line no1][-line no2] 


Examples LIST 100- 

Usts from line 100 on the screen. If there is no line 100 
it will LIST from the next line in sequence. 


Remark LIST is optionally followed by a start line number and a 
finish line number, either of which may be omitted. If both 
are omitted the entire program will be listed. 
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5 . 13.8 Function LLIST causes HUNTER to list the Basic program to the 
serial port. 

Syntax LLIST [line no.1][-line no.2] 

Examples LUST 100- 

will cause a listing to start at line 100 in the program. 


Remarks LLIST is optionally followed by a start line number and a 
finish line number, either of which may be omitted. If 
both are omitted, the entire program will be listed. 

LLIST can be terminated at any time by the escape ('ESC') 
key being depressed and held down until HUNTER responds 
with a confirmatory 'beep'. Because a transmission buffer 
is used, up to 256 characters may remain for transmission 
after 'ESC is confirmed. Power OFF will also abort a 
listing at any time without loss of stored data or program. 

It is advisable to check HUNTER'S Communication Parameters, 
see section 6.4, COMMUNICAHON PORT SOFTWARE, before using 
LUST for compatibility with the external device receiving 
the data. When a printer is being used, remember to check 
for baud rate and line feed requirements. Unless "Echo" is 
enabled in transmission parameter, there is no data echoed 
onto the screen. 

NOTE: Because the communications power supply is powered up 
by LLIST, a single high-to-low character will appear at the 
start of the record. Many systems will see this transition 
as a single, spurious, character. To avoid this problem, 
power up the interface first with either: 

LPRINT " " or OUT 132,1 

otherwise, it may be necessary to edit out this character 
on the host system. 


VER.V09F 


PAGE 5-71 








BASIC FUNCTIONS 


SECnON 5.13 


LLOAD 


5 . 13.9 Function LLOAD command allows the HUNTER to load Basic programs 
through its serial port. 


Syntax LLOAD 
Exaoples LLOAD 

Loads Basic source from the RS-232 port. 


Remarks Programs which were output using LLIST onto a storage 
medium, e.g. disk or another HUNTER may be reloaded using 
this command. LLOAD is terminated by typing ESC. See 
section 3.6, LOADING FILES, for a detailed description of 
program loading/unloading options. 

Be sure to check HUNTER'S receiving parameters for compati- 
bility with the device transmitting data. 

LLOAD data goes into memory via the Basic interpreter input 
routine and is syntax checked on the way - if errors or 
spurious data are found in the incoming data, HUNTER will 
stop loading and display; 

» SYX Error 

If this occurs at the start of a file, it is likely that 
some header data, not in Basic syntax, has caused the 
problem. 

<!“iokly, as HUlfrER's Input buffer 
will still be receiving data. 

LLOAD does not echo incoming characters onto the screen. 
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LN 


5 . 13.10 Function LN generates the NATURAL logarithm of X, i.e: logarithm 
to base e of X. 


Syntax LN(N) 

where N is a numeric expression. 

Examples LN(8) 

generates the logarithm to base e of 8. (2.079^111601991) 

If S=9.12 then; 

LN(S) 

generates the logarithm to base e of 9.12.(2,210H698CW2074) 
LN(-91) 

generates a 'Magnitude Error' and program execution will 
stop. 


Remarks X must be greater than zero. 

If X is negative or equal to zero then a 'Magnitude Error' 
will occur. 

X may be an expression. 


f 


VER.V09F 


PAGE 5-73 






BASIC FUNCTIONS 


SECnON 5.13 


5.13.11 Function 

LOAD reads a program into the Basic workspace from a 
file. 

Syntax 

LOAD filename [,R] 

Exanple 

LOAD "HUNTER.HBA" 

loads the Basic file, HUNTER.HBA into the workspace ready 
for execution. 

LOAD "HU^^•ER",R 

loads the Basic file HUNTER.HBA into the workspace and 
commences execution. 

LOAD "HUNTER.TXT" 

This loads an ASCII file into the Basic workspace. It 
processes the ASCII into Basic compressed format. 

Remarks 

For .HBA files, typing in the extension is optional. 
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5.13.12 


Function LOC returns the 
sequential file 


number of records read/written to a 


Syntax LOC(file no) 


Example 100 MAXFILES=2 

110 OPEN •'TEST”F0R INPUT AS #2 
120 INPUT#2,A 

130 IF E0F(2)=0 THEN GOTO 120 
140 PRIMr»End of File" 

150 PRINP'No. of records read = ";L0C(2) 
160 CL0SE#2 
170 END 


When the end of file has been reached the number of 
that have been read will be displayed. 


records 


Remarks The LOC^) function can also be used to display the number 
of records written to a file. 

NOTE: the program to create the data file TEST could be of 
the form! 


10 OPEN "TEST" FOR OUTPUT AS#1 
20 FOR X=1 TO 100 
30 WRITE#1,X 
40 NEXT 
50 CLOSE# 1 
60 END 

NOTE: A record consists of 128 bytes, so LOC gives a 
measure of the amount of file space used. 
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lcx:ate 


5 . 13.13 Function LOCATE sets the text cursor on the screen. 


Syntax LOCATE x,y 

Maximum Value 


{Character Set 
1 

! X 
1 

1 y 

1 

1 Text mode 

1 

1 79 

1 23 

1 Char 0 

1 239 

1 63 

1 Char 1 

1 30 

1 5 

1 Char 2 

1 30 

1 5 

1 Char 3 

1 30 

1 5 

1 Char M 

1 30 

1 5 


I I 


Example 10 LOCATE 0,0 

Places the cursor in the top left-hand comer. 


Remarks LOCATE is most useful for locating the cursor before 
printing text onto the display. LOCATE operates 
differently in text mode and graphics mode. 

Text Mode: Addressing a location outside the current window 
will cause the window to move so that the new cursor 
position is visible. 


The maximum values for the parameters are X = 79 and Y = 
23} being the size of the virtual screen. 


Values greater than the maximum for X will cause wrap- 
aroui^ on the same line. Values greater than the maximum 
for Y will remain at the bottom of the screen. 

Graphics Mode: A SCREEN 1 command will reset the cursor to 
the origin at (0,0). When character set zero is selected 
the LOCATE co-ordinates are referenced to the graphics 
otherwise, the co-ordinates specified in 
LOCATE refer to the top left hand pixel of a 7 x 5 

character which is equivalent to a CHARI 
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5 . 13 . 1 ^ Function 
Syntax 

Examples 


Remarks 


LOG 


LOG generates the logarithm to base 10 of X. 

LOG(N) 

where N is a numeric expression. 

LOG (32) 

generates the logarithm to base 10 of 32. 

If S=1.319 then: 

LOG(S) 

generates the logarithm to base 10 of 1.319. 

L0G(-6) 

generates a 'Magnitude Error' and programme execution will 
stop. 

X must be greater than zero. 

If X is negative or equal to zero then a 'Magnitude Error' 
will occur. 

X may be an expression. 
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LOPCHR 


5.13.15 Function 

LOPCHR outputs characters 
their ASCII values defined 

to the RS-232 port which have 
as decimal argument(s). 

Syntax 

LOPCHR numerical exprssion 

1, numerical expression 2... 

Examples 

LOPCHR 61,62 displays => 


Remarks 

This permits computing of characters and also advanced 
functions such as cursor addressing. The argument should 
be 0 - 225. 
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LPRINT 


5.13.16 F\inction LPHDIT outputs to the serial port. 


Syntax LPRINT expressions. 


Examples LPRINT A,B,C$ 

Outputs variables A,B and C$ to the serial output port. 


Remartcs LPRINT is exactly equivalent to PRINT except that output 
goes to the serial RS-232 port and not the screen. 

See PRINT for a full description. 

LPRINT formats can be altered by the follovd.ng statements: 
LPRINT % U % 

sets the number of decimal places equal to N, a number in 
the range 0-9. Rounding occurs up or down as appropriate. 

LPRINT X Z N t 

sets the number of trailing zeroes (or decimal places) 
equal to N, a number in the range 0-9. 

LPRINT % E % 

sets all following LPRINT formats to scientific notation. 
LPRINT % % 

restores LPRINT format to normal 
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5.13.17 Flinction 

LTRON turns on the trace but sends the trace output to the 
printer. 

Syntax 

LTRON 

Examples 

LTRON 

Remarks 

LTRON, terminated with TROFF, produces the same output as 
TRON but on an external printer. 

See TRON for a full description. 
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MAXFILES 


5.14.1 Function MAXFILES defines the maximum number of files that may be 
opened simultaneously. 

Syntax MAXFILES = n 

Exanples MAXFILES = 4 

Sets the maximum number of files that may be opened 
simultaneously to four. 

Remars MAXFILES will perform a 'CLEAR' operation destroying all 
existing symbol table entries. It must therefore be 
defined at an early point in the program. 

MAXFILES may also be used for input, for example: 

100 PRINT "Maximum number of files to be opened = MAXFILES 

will display: 

Maximum number of files to be opened = 4 


If no MAXFILES has been specified a default value of one is 
taken. 

The maximum number of files that may be opened simultaneous- 
ly is 15. 
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5. 1^.2 Function MID$ returns a substring of given length starting at the 
given position. It may also be used as a statement. 


Syntax B$=MID$ (A$,X, [Y]) 
or 

MID$ (A$,X,[Y]) = C$ 

Examples 10 A$= "ABCDEFGH" 

20 PRIFn* MID$ (A$,3,^0 
Prints CDEF 


Remarks A$,X or Y may be expressions. If Y is omitted then all 
characters to the right of the Xth character are returned. 
In the above example: 

MID$ (A$,0,3) = 'ABC' 

MID$ (A$,20,5) = null string 
MID$ (A$,7) = 'GH* 

Irfhen MID$ is used as a statement in the form: 
MID$(A$,X[,Y])=C$ 

its sets the part of A$ starting at the Xth character with 
the substring C$. The optional parameter Y denotes the 
length of the part of A$ to be replaced and if omitted 
defaults to the length of C$. 
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NAME 


5.15.1 Function NAME renames a HUNTER file. 

Syntax NAME old name AS newname 

Example NAME "VERSION liiBA" AS "VERSION 2.HBA" 

NAME A$ AS B$ 

Renames the file VERSION1.HBA to VERSI0N2.HBA 

Remarks After the NAME command, only the filename is altered. 

Filenames can be up to eight characters long with a three 
character extension. 
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NEW 


5.15.2 Function NEW will re-inltlalise all HUNTER'S user memory and reset 
all program pointers. 

Syntax NEW 

Examples READY 
NEW 

Are you sure (Y/N)? Y 
54613 bytes available 
READY 


Renarks All program lines are erased I 

N^ should, therefore, not be used if several programs are 
to co-exist in the same HUNTER. programs are 

HUNmR^f^*® before loading a new user program into 
HUNTER to ensure the maximum use of space. 

NEW replies with: 

Are you sure? (Y/N) 

If any response to the confirmation message other than YES 


Fllespace is not affected by 'NEW* 
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NEXT 


5.15.3 Function NEXT is the last statement in a FOR NEXT loop. 

Syntax NEXT [V] 

V is optional and is a variable name that corresponds to 
the original FOR statement. 

Exanples NEXT I or NEXT 
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5.16.1 Function 

ON BREAK allows the user to interrupt processing by 
operation of the BRK (Break) key. 

Syntax 

ON BREAK GOTO [line] 
or 

ON BREAK OFF 

Examples 

ON BREAK GOTO 1000 
ON BREAK OFF 

Reoarks 

This statement operates in a similar manner to the ON POWER 
statement, except that the break key is monitored instead 
of the power key. 
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ON COM 


5.16.2 Furxition ON COM defines a routine to be executed when data is re- 
ceived into the communications buffer. 


Syntax ON COM GOSUB line nunber 


Example 10 ON COM GOSUB 100 
20 COM ON 


100 »SUBROUnNE TO READ 
110 'IfiCOMING DATA 


190 RETURN 


Remarks This statement is used in conjunction with the COM 
statement. It tells Basic where to jump to in the event of 
a communications interrupt. 

Data may be left in the communications buffer for as long 
as is necessary. 

On an interrupt an automatic COM STOP is executed so inter- 
rupts are never nested. The RETURN from the trap routine 
performs an automatic COM ON, so re-activating the inter- 
rupt routine, unless a COM OFF statement was executed 
before the RETURN. 
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5.16.3 Function 

ON COMMS allows communication errors (typically a protocol 
failure) to be handled by the user’s application program. 

Syntax 

ON COMMS GOTO [line no] 
or 

ON COMMS OFF 

Examples 

ON COMMS GOTO 1000 
ON COMMS OFF 

Remarks 

The statement operates in a similar manner to ON POWER. 

When a communications error is detected, control is 
returned to the Basic Interpreter. Execution continues from 
a defined line number specified in the Basic program. 

In order to allow normal communication error messages the 
statement ON COMMS OFF disables this mode. The byte of 
memory COMERR is available to the programmer and contains a 
code which represents the type of error which has occurred 
in the communications. The available codes and their 
meaning are described more fully in section 6.7.8, 
COMMUNICATION ERROR. 

In a typical application, ON COMMS would be used to present 
the Operator with a plain language statement of the form: 

"Communications have failed. Please re-dial and try 
again". 

Re-trys or repeat blocks can also be controlled by the user 
program, as required. 
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5.16.y Function 
Syntax 


Exanples 


Renerks 


ON ERROR 


ON ERROR is used to catch 
a Basic Error message. 


errors which would 


normally give 


ON ERROR GOTO [line no] 
ON ERROR GOTO 0 


10 ON ERROR GOTO 1000 
20 INPUT A 
30 A = SQR(A) 

'^O PRINT A 
50 GOTO 20 
1000 A =ABS(A) 

1010 PRINT "NEGATIVE NUMBER CORRECTED" 

1020 RESUME 30 

conditlon^*^^^ negative numbers and correct the 


error handling subroutine. 

Any error can be trapped. However, ON ERROR is 

®'‘ro'’3 e.g. magnitude errors 
Which could be caused by operator input etc. 

An ON E^OR trap must be exited by either an RESUME 
statement or by ON ERROR GOTO 0 which will give the normal 
Basic error message. 
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ON..GOSUB 


5.16,5 Function ON...GOSUB... allows conditional subroutine calls. 

Syntax ON expression GOSUB line number 1, line number 2, ....line 
number n. 


Exanples 10 ON A GOSUB100,180 
20 PRINT "HELLO" 

If A=1 then program execution will go to line 100 and will 
then go to line 20 when a RETURN is encountered. 

If A=2 then program execution will go to line 180 and will 
then go to line 20 when a RETURN is encountered. 

10 B=100:C=300;D=350 
20 ON A GOSUB B,C,D 
30 PRINT "HELLO" 

If A=1 then program execution will go to line 100 and 
revert back to line 30 when a RETURN is encountered. 

If A=3 then program execution will go to line 350 and 
revert back to line ?0 when a RETURN is encountered. 


Remarks 


ON GOSUB will cause program execution to go to a line 
number chosen from the list of line numbers positioned 
immediately after GOSUB. The selection of a particular 
line number in this list is determined by the value of 
[expression]. 

Once program execution has been forced to go to one of the 
sel^ted line numbers, each statement following that line 
number will be executed in order until a RETURN is 
encounter^. At this point program execution will revert 
back to the statement following the list of line numbers. 

The integer part of [expression] is used so that if A-2 9 
program execution will go to line 180 in the example. 
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NOTE; The value of [expression] is NOT rounded up. 

If the value of [expression] is zero or greater than the 
number of line numbers in the list, then program execution 
will continue with the next statement. 

In the above example, if A=3 then "HELLO" will be printed 
IMMEDIATELY. 

The maximum value of [expression] allowed is 255. 

If the value of [expression] is greater than 255 or 
negative then a 'Magnitude error' will occur. 

The line numbers in the list of line numbers may themselves 
be expressions. 
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ON..GOTO 


5.16.6 Function ON. ..GOTO... allows conditional jumping. 

Syntax ON expression GOTO line number 1, line number 2, ....line 
number n. 


Exanples 10 ON A G0r0100,200,300 
20 END 

If A=1 then the program will go to line 100 
If A=2 then the program will go to line 200 
If A=3 then the program will go to line 300 

If A=1.3 then the program will go to line 100. 


Remarks ON GOTO will cause program execution to jump to a line 
number chosen from the list of line numbers positioned 
immediately after GOTO. The selection of a particular line 
number in this list is determined by the value of 
[expression]. 


The line numbers may themselves be expressions. 


The value of [expression], in the above example A, is 
truncated to an integer. 

It must be noted that the value is truncated to an integer 
and NOT rounded up. So if the above example A=1.9 then the 
program will go to line 100. 


If the value of [expression] is zero or greater than the 
number of line numbers in the list, then program execution 
Will continue with the next statement. 


In the above example, if A=^, or 
will automatically go to line 
executed. 

The maximum value of [expression] 
If the value of [expression] is 


if A=0 then the program 
20, and an END will be 

allowed is 255. 
greater than 255 then a 
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’Magnitude Error' will occur and program execution will 
stop. If in the above example A=256 then an error will 
»cur. A 'Magnitude Error' will also occur if the value of 
[expression] is negative. 

Example: 

10 ONAGOTO 100, 200, 300: PRINT '»HELL0» 

20 END 

If A>3 or A=0 then the program will not go to any of the 
lines but will immediately print "Hello", and then END will 
be executed. 
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5.16.7 Flinction 

ON KEY specifies a routine to be executed when a soft key 
or cursor control key is pressed during program execution. 

Syntax 

ON KEY (n) GOSUB line number 

Examples 

ON KEY(I) GOSUB 5000 

If function key 1 is pressed the program will execute the 
subroutine located at line 5000. 

Remarks 

For a definition of n and details of using this function 
see the KEY (N) statement. Line number specifies the trap 
routine, which must be terminated with a RETURN. 
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5.16.8 


ON POWER 


annual ow ay dlJU Vt 

execution if a user presses the power off key. 


Syntax ON POWER GOTO [line no] 
or 

ON POWER OFF 

Examples ON POWER GOTO 1000 


Remarks This statement causes the OFFVECT locations to be loaded 
with a vector so that if operation of the power down key is 
detected, program execution occurs from the line number 
specified. 

Operation of the break key, or a syntax error, will cause 
the vector to be >re-initialised to enable the power on/off 
switch to function normally. 

ON POWER OFF 

This statement also re-initialises the OFFVECT location. 


VER.V09F 


PAGE 5-95 






BASIC FUNCnOHS 


SECnON 5.16 


5.16.9 Function 

ON POWER RESUHE restarts program 

Syntax 

ON POV€R RESUME 

Examples 

ON POWER RESUME 

Remarlcs 

After HUNTER has been switched off, either by the power off 
key or any other means, switching HUNTER on will restart 
the program from the point where it was switched off, even 
if input was in progress. 

Exit from ON POWER RESUME is made by holding down 'control 
and C before pressing the power on key and entering the 
escape code, see section 3.8.^^, Exiting 'COMP, for details 
of entering the escape code. 
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5.16.10 Function 

ON TIMEi specifies a routine to be executed at a defined 
time. 

Syntax 

ON TIME$ = A$ GOSUB line number 

kS is a string defining the interrupt time 

Exanple 

10 ON TIME$ = "12:00:00" GOSUB 1000 

Remarks 

The executing program will be interrupted at the specified 
time and execution will begin again in the subroutine 
beginning at 'line number'. 

The time is checked at the beginning of a new statement, 
therefore if Basic is waiting on an input, for example, the 
interrupt will not occur immediately. 

NOTE: ON TIMES is only effective when HUNTER is powered up. 
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5.16.11 Function 

OPCHR outputs characters to the screen which have their 
ASCII values defined as decimal argument(s). 

Syntax 

OPCHR numerical exprssion 1, numerical expression 2... 

Examples 

OPCHR 61,62 displays => 
OPCHR 1 clears the screen. 

Remarks 

This permits computing of characters and also advanced 
functions such as cursor addressing. The argument should 
be 0 - 255. Arguments greater than 255 will give an 
argument error. 

Cursor addressing: 

Example: OPCHR 15,5,3 

The argument 15 instructs HUNTER Basic to interpret the 
following two arguments as cursor co-ordinates x,y 
respectively. It must be noted that re-positioning the 
cursor in this manner will not cause the virtual screen 
window to be re-positioned over the relevant area of the 
virtual screen automatically. If automatic re -posit ion IrK 
is required then use LOCATE. 
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5.16.12 Function OPEN opens file for I/O 

OUTPUT 

Syntax OPEN "file name" FOR APPEND AS file no. 

INPUT 


Example 10 OPEN "OUTFIL.TXT" FOR OUTPUT AS 1 

This will open the file "OUTFIL.TXT" for output from a 
Basic program as file number one. 

or 1C OPEN "APPEND.TXT" FOR APPEND AS 3 

This opens the file "APPEND.TXT" as file number three. Any 
data written to the file will be appended. MAXFILF.S must 
have previously been set to a minimum of three. 

or 10 OPEN "INPUr.TXT" FOR INPUT AS M 

The file is opened for input as file number four, this will 
allow the data in the file to be read by a Basic program. 

Remarks When a file is OPENed HUNTER'S firmware automatically 
performs a checksum generation on the file and compares it 
to a value stored in the file directory, when the file was 
last CLOSEd. Any inconsistency will result in a 'DSK 
ERROR' being returned to the user. 

The OPEN statement parameter FOR has three options 
OUTPUT, APPEND and INPUT, they perform the following 
functions: 

OUTPUT : This will open a file for output. Any data that 
is in the file will be lost. 

APPEND : This will also open a file for output, but any 
data that is output to the file will be added to the end of 
the data that is already present. 

INPUT : The file is opened for input. This will allow a 
Basic program to read data from the file. 

The file number cannot be greater than the number specified 
in MAXFILF.S. If MAXFILES 3 has been specified the file 
number cannot be greater than three. 
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OUT 


5.16.13 Function OUT outputs a byte of data to a specified port. 
Syntax OUT address, data 1, data 2.. ..data n. 


Examples OUT 133,1 

Switches DTF to the off state. 


Remarks OUT is used to control internal HUfTTER functions like power 
control. See section 9.8, PORT ALLOCATIONS, for details of 
port addresses. 
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PEEK 


5.17.1 Function 

PEEK fetches the value of a designated byte in HUNTTER's 
memory. 

Syntax 

PEEK (ADDRESS) 

where ADDRESS is a numeric expression. 

Examples 

PRINT PEEK (17933) 

Vcllln location 17933 (in decimal) on the LCD 

Remarks 

PEEK requires the decimal value of the required memory 
location as an argument. See also DEFSEG to set the paae 
address. 
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PI 


5.17.2 Function 

PI is used to return the value of PI 

Syntax 

A = PI 

Exanple 

10 INPUT "ANGLEIN DEGREES", A 

20 LET B = A»PI/180 

30 PRINT A;"DEGREES ARE";B;"RADIANS" 


This program will convert an angle in degrees to an angle 
in radians. 

Remarks PI is returned with 6 digit precision i.e. 

PI = 3.U159 
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POINT 


5.17.3 Function POIIIT returns the 'colour' of the specified pixel. 


Syntax A = POINT (X,Y) 


Example 10 REM Invert the graphics screen 
20 FOR X = 0 TO 239 
30 FOR Y = 0 TO 63 

MO IF POINT(X.Y) = 1 THEN PRESET (X,Y) ELSE PSET (X,Y) 
50 NEXT Y:NEXT X 


Remarks An odd number returned by the function indicates a black 
pixel, while an even number indicates a white pixel. If 
the co-ordinates are out of range then -1 is returned. 
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5.17.4 Function 

POKE allows the user to write to a specified location in 
HUNTER’S memory. 

Syntax 

POKE address, data 1, data 2 data n. 

Examples 

POKE AD,1 

Pokes the value 1 into location AD. 
Variable AD contains the address to be POKEd. 

Remarks 

The data can be a variable or an expression and must be in 
the range 0-255. Values greater than 255 will give an 
argument error. See also DEFSEG to set the page address. 

WARNING Use POKE with care. 
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POP 


5.17.5 Function POP fetches (POP's) a value from the machine code sub- 
routine linkage stack. 

Syntax POP(N) 

where Nmumber of parameters to be POPPED. 

Examples A=P0P(2) 

POPs two values off the machine code linkage stack. 

A=latter parameter. 

Remarks Allows Basic to access 16 bit results from machine code 
subroutines. 

Refer to section H.8, MACHINE CODE CALLS, which discusses 
machine code calls. 

WARNING do not attempt to pop more variables from the stack 
than have been pushed. 


VER.V09F 


PAGE 5-105 







BASIC FUHCnOHS 


SECnON 5.17 


POS 


5.17.6 Function POS returns the current cursor position on the line. 

Syntax POS(n) n is a dummy argument. 

Examples A=POS(X) 

Variable 'A' contains the current cursor column position. 
Remarks The returned value will be in the range 1 to 80. 
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POWERn 


5.17.7 Function PCWER n auto power off period. 


Syntax POWER n 


n is in the range 10-255 and is the number of 5 second 

I^GPXOQS • 


Examples POWER 12 

will switch HUNTER off after 1 min. 

POWER 0 

will prevent timed switch off. 

Remarks POWER 0 will enable the power off key after POWER CONT has 
been executed. 

To remind the user that HUNTER has been left switched on. 
HUNTER will emit a bleep every 150 seconds. Power n is 
reset to the default value (n=60, or 5 minutes) after power 
off /on and should be re-initialised by the user's program. 
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5.17.8 Function 

POWER COirr disables the power off key and tine outs. 

Syntax 

POWER CONT 

Examples 

POWER CONT 

This will disable the power off key and tine outs. 

Remarks 

To enable the power off key and tine outs use POWER n. 

Use of POWER CONT allows the user program control of the 
power key to force, for instance, completion of a data 
entry sequence before the unit can be powered down. 
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POWER OFF 


5.17.9 Function POWER OFF switches HUNTER off 


Syntax POWER OFF 


Examples POWER OFF 


Remarks After POWER OFF has been executed switching HUNTER on will 
automatically run the program from the start. 

To exit from POWER OFF press ’Esc’ and enter the code 

56580. 

Power off is used in applications where ’Cont filename’ 
could give confusing results if the unit is left in an 
uncontrolled state by a previous user. 
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5.17.10 Function 

POWER OFF, RESUME switches HUNTER off. 

Syntax 

POWER OFF, RESUME 

Exaoiples 

POWER OFF, RESUME 

Remarks 

After POWER OFF, RESUME has been executed switching HUNTER 
on will re-start the program from the next statement and 
restore the screen. 

Unlike POWER OFF, this function does not require the code 
56580 after 'Esc' in order to exit from the program. 
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PRINT 


5.17.11 Function PRIIT displays data on the LCD screen. 

Syntax PRINT expressions [;] 
or ? expressions 

The question mark is exactly equivalent to PRINT 
Example PRINT X,Y,Z$ 

Prints the values of the three variables X,Y, and Z$ in 
columns 1, 1M, and 28 and finishes with CR/LF. A PRINT 
statement with no expressions Just performs the CR/LF 
functions. 


Remarks The comma between the expressions move the print cursor to 
the next zone, where each zone is fourteen spaces wide. 
The use of semi-colons causes the values to be printed 
together without gaps. However, numerical data leaves a 
space at the start for the minus sign, and includes one 
blank space afterwards. A semi-colon at the end of the 
line suppresses the CR/LF. 

Examples: 


PRINT "FOOP' + "BALL" outputs FOOTBALL 


or 


PRINT X;"SQUARED IS"; 
PRINT X»X 


or 

IF A<2 THEN PRINT "A=";A 


or 


outputs, if X=2 
2 SQUARED IS M 


outputs, if A=1 
A=1 


PRINT CHR$(1); 


will clear the LCD display. 
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PRINT# 


5 . 17.13 Function PRINT# writes data to file. 


Syntax PRIhrr#file no,var1 ;var2; . . . .varX 


Examples PRINT #^4,A$;B4;D$ 
or 

PRINT#1,X;Y;Z 

The variables specified are written to the appropiate file 
nun4>er. 


Remarks Variables should be separated by semicolons and not commas. 

As PRINT# outputs to the file in the same way as it would 
to the screen, any spaces present if commas were used would 
also be written to the file. 

Care should be taken when writing string data to files as 
they should not contain any commas, semicolons, leading 
blanks, carriage returns or line feeds as they would be 
interpreted as delimiting characters. If it is necessary 
to include any delimiting characters in a string the 
variable name should be enclosed in double quotes by using 


For example, if A$ =»'TOM,DICK»' and B$='*HARRY". The 
statement: 

PRINr#2,A$;B$ 

would write the following to the file: 

TOM,DICKHARRY 
and the statement: 

INPUT#2,A$,B$ 

would input 'TCM» to A$ and 'DICKHARRY* to r. 
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To separate the data correctly the following format should 
be used: 

PRINT #2, CHR$(3« ) ; A$;CHR$(3^I ) ;CHR$(34 ) ;B$; CHR$(34 ) 

This would write the following to the file; 

"TGM,DICK"»’HARRY" 

and the statement: 

INPUT#2,A$,B$ 

inputs 'TOM, DICK' to A$ and 'HARRY' to B$ 

The statement WRITE#n is a simpler way to perform the above 
functions. 
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SECnON 5.17 


PSET/PRESET 


5 . 17 . 1 ^ Function PSET and PRESET are used to set or reset an individual 
pixel at the specified coordinates. 


Syntax PSET (X1,Y1 ),(X2,Y2),(X3,Y3),... 

PRESET (XI, YD, (X2,Y2),... 

Any nunber of points may be specified in one statement. 

(x,y) are the coordinates of the pixel to be set or reset 
and must lie in the range 0<x<239 and 0<y<63. The 
coordinate (0,0) refers to the top left corner of the 
screen. 


Exanples PSET(0,0), (239, 0), (0, 63), (239,63) 

Will set the four comer pixels black. 


Remarks PSET and PRESET are graphic statements and win default the 
screen to graphic mode. If when a PSET/PRESET statement is 
encountered the screen is in text mode, it will auto- 
matically change to graphic mode. 

PSET sets pixels (turns them black) 

PRESET resets pdxels (turns them white) 

Each time a pixel is set or reset using PSET and PRESET the 
graphic cursor is moved to that pixel. 
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SECTION 5.17 


PUSH 






. xuuxc I, variaoie ....variable n. 


Exanples PUSH A,B 


binary) representation of the 
variables A and B onto the stack. 


Remarks variables may be accessed or modified by a machine 

code program. See section 4.8, MACHINE CODE CALLS. 

POP is the reverse of PUSH. 
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READ 


5.19.1 


Function 


READ is used to input constants 
DATA statement. 


previously defined in a 



Remarks 


an'erTr'tm resuTf exhausted, when 

using RESTORE. sequence may be restarted by 


variable type in READ must I 
corresponding DATA items: if not, a RE 


the same as the 
ERROR will occur. 
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5.19.2 Function 
Syntax 

Exaople 

Remarks 


REM 


REM denotes that the following text is a comment statement 
only. 


REM text 
or 

’ text 


1000 REM THIS ROf/riNE CLEARS THE DISPUY 
1010 REM 

1020 PRIwr CHR$(1); 

1030 RETURN 


considerably improve readability but only at the expense of 
extra memory. Unnumbered REM statements can be used in 
host computer files which will be ignored when down loaded. 


The apostrophe may be used instead of 'REM', but has an 
extra capability. When delimiting a comment after a Basic 
statement, the colon is unnecessary. 


10 X=X+1' THIS TYPE OF COMMENT SAVES MEMORY SPACE 


REM statements are also used as HELP source text. 
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5.19.3 Flinction 

RESTORE is used with READ. RESTORE initialises the current 
DATA pointer to the first DATA statement in the program. 

Syntax 

RESTORE [line number] 

Exanple 

RESTORE 120 

This restores the data pointer to line 120. 

Remarks 

RESTORE may also be used with a line number argument. This 
will initialise further READ functions to a specified line. 
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RESUME 






Exanple 


10 ON ERROR GOTO 100 
20 IF A<B THEN ERROR 110 


100 IF ERR>100 THEN RESUME L2+(ERR/10) 

Remarks If there is no argument in the statement then execution 
will begin again at the statement which caused the error. 

Cline^ni*!SlJrl^^”? following statement and RESUME 

lime nunberj begins at the specified line. 
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5.19.5 Rjnction 

RETURN from subroutine. 

Syntax 

RETURN 

Exan^les 

10 GOSUB 100 

100 PRINT I 
200 RETURN 

Remarks 

RETURN is the logical conclusion of a GOSUB statement. 
Placed at the end of the subroutine, RETURN causes 
execution to continue at the next statement following the 
original GOSUB statement. 
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5.19.6 Function 

RIGHT! returns the last n characters of a given 
string. 

Syntax 

RIGHT$("STRING",N) 

where N is the number of rightmost characters to be 
returned. 

Exaoples 

RICHT$("ABCDEF",3) 
returns DEF 

Remarks 

Both string and n must be enclosed in parentheses and can 
be expressions. If length of the string is less than n 
then the entire string is returned. 

If A$ = "ABCDEP 

then: 

RICHT$(A$,0) = null string 
RIGHTKA$,20) s ABCDEF 
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RND 


5.19.7 Function RND returns a 14-digit psuedo random number in the range 
0 - 0.99999999999999. 

Syntax RND(O) 

where "0” is a dummy argument. 

Examples A = RND(O) 

sets A equal to a random number. 

Remarks RND requires a dummy argument. 
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RUN 


5.19.8 


Function RUN causes program execution to commence. 


Syntax RUN [line number] [numerical expression] [filename] 


Examples RUN 1000 


Remarks 


causes execution to commence from line 1000. 

RUN is useful when program de-bugging as it initialises the 
system stacksi GOTO does not. 


for ewmple ^ variable or an expression, 


RUN A 
RUN A»100 


or 


RUN "filename" 

causes the "filename" to be loaded and executed from the 


RUN is a direct Basic command only. 
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5.20.1 Flinction 

SAVE writes a program into the file space. 

Syntax 

SAVE filename 

Example 

SAVE "HUNTER.HBA" 

Remarks 

The Basic program is written to the files pace in RAM. If a 
file already exists with the same filename, then the old 
file is overwritten. Filenames are up to eight characters 
long. The extension .HBA is automatically appended for a 
Basic program, if an alternative is not provided. 

An appropriate error message is displayed if there is 
insufficient file space for the program file. 
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SCREEN 


5.20.2 Function SCREEN changes the mode of operation of the LCD screen. 


Syntax SCREEN n 

n may be any numeric expression returning either a 0 or 1. 
Any other value will give a Magnitude Error. 


Example SCREEN A-A will put the screen into text mode. 

SCREEN 1 will put the screen in graphic mode. 


Remark TEXT MODE (SCREEN 0) 

This is the main mode of operation for the HUNTER. This 
mode is used to list Basic programs and to enter programs. 
In this mode the output is purely textual and gives a 
window of 8 lijies of 40 characters on a virtual screen of 
24 lines of 80 characters. 

GRAPHIC MODE (SCREEN 1) 

In this mode the user is given much more control over the 
screen with high resolution graphics and up to 5 different 
types of character set. 

NOTE: Graphic commands set SCREEN 1 mode automatically. 
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SGN 


5.20.3 Function SGN returns the value of the sign of the 
argunent. 


Syntax SGN(N) 

where N is a numeric expression. 


Examples A = SGN (-9.5) 

sets A equal to -1 
A = SGN(O) 
sets A equal to 0 
A = SGN(1.76E9) 
sets A equal to 1 

Remarks Result: 

1 if Positive 
0 if Zero 
-1 if Negative 


VER.V09F 


page 5 - 128 


BASIC FUNCTIONS 


SECTION 5.20 


5.20.4 Function 

SIN returns Sine of the argument. 

Syntax 

SIN(N) 

where N is a numeric angle in radians. 

Examples 

J = SIN(2.56) 

sets J equal to the value of the sine of 2.56 
radians. 

PRINT SINC2.56) gives: 

.549355436427 

Remarks 

The argument is expressed in radians. 
To convert to degress then: 

J = SIN(A/180»PI) 
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SOUND 


5.20.5 Function SOUND generates a note of a specified frequency and length. 


Syntax SOUND pitch, duration. 


Example SOUND 121,530 

This will produce a middle 'C note for one second. 

The following program will play a short tune: 

10 FOR 1=1 TO 20 
20 SOUND 52, 1233/1 
30 SOUND 46, 139 VI 
40 SOUND 59,1086/1 
50 SOUND 121,530/1 
60 SOUND 80,1202/1 
70 FOR J=I TO 16 
80 NEXT J 
90 NEXT I 
99 END 


Remark Pitch and duration must be in the range 1 - 65,534. 

A higher value for pitch will produce a lower note. 

A higher value for duration will Increase the length of the 
note. 

The formula, 64 130/ pitch, can be used to find the required 
’duration' parameter to play a note of a specified pitch 
for one second. 

See section 9.12, FOUR OCTAVE SOUND RANGE, for parameters 
to generate specific notes of required frequency. 
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SPACES 


5.20.6 Fu»:tIon SP*CE» 1, used to return a string consisting of n spaces. 


Syntax 

SPACE$(n) 

Example 

10 DIM A$ (0,10) 

® consisting of the digits 1 2 T 

followed by 3 spaces followed by the letters A.B.C.D ’ 


Remarics The parameter n is an Integer In the range 0 to 265, 
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SPC 


5.20,7 Function SPC moves the cursor along the line by printing spaces 

Syntax PKlfTT SPC(n) 0<n<255 

Examples 100 PRINr"HELLO»»;SPC(10);»HOW ARE YOU ?»' 

Will display: 

HELLO HOW ARE YOU ? 


Remario SPC must be used with one of the PRINT statements. 
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SQR 


5.20.8 Function SQR returns the square root of the argument. 
Syntax SQR(N) 

where N is a numeric expression. 


Examples Q = S0R(16) 

sets 0 equal to 4. 

Remarks The argument must be positive. 
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SRCH 


5.20,9 Function SRCH function enables an array to be searched for the 
occurrence of a specified element within that array. 


Syntax SRCH«array element>,<numerical expression>) 

The array element specified is used as the reference to be 
searched for in the remaining array. 


Examples PRINT SRCH(A$) 

A=SRCH(A(5),3) 

IF SRCH(A!(0), 1)<» THEN 0PCHR7 


Remarks Consider the following program. 

10 DIM A$(10,20) 

20 A$(0)="ABCDE" 

30 A$(1)=»AB" 

40 A$(2)=«ABCDE" 

50 A$(3)="ABCDE" 

60 A$(4)=»»ZXYZ" 

70 A$(5)="ABCDE» 

100 INPUT X,Y 

110 PRINT SRCH(A$(X),Y) 

120 GOT0100 


When found the element number is returned. If not found 
then zero is returned. 

The function searches from the specified element to the end 
of the array. As an option, up to 255 occurrences can be 
checked for by specifying in the argument the number of 
repeat occurrences. 

If this value is 256 or larger a syntax error will occur. 

The result of SRCH is a numeric value which can be used in 
arithmetic expressions etc. 

The search function can also be used on simple or double 
precision arrays. uuuuj.e 

The following are the results of search on the above array; 

SRCH(A$) gives 2 ; as element (2) is the first 
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occurrence of element (2) 

SRCH(«(iO) 0 : as element (H) 1, not found else- 


When search is applied to numeric 
must be exact for equality. 


arrays the 


comparison 


O'" a subset of, the searched string. 


PRINT SRCH(A$(D) 

would return 2 as A$(1) is a subset of A$(2). 
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5.20.10 Function 

STOP terminates program execution and prints a message on 
the LCD screen. 

Syntax 

STOP 

Examples 

550 STOP 
causes: 

»BREAK IN UNE 550* 

Remarks 

Typing COIT causes execution to continue from 
the line following STOP 
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5.20. 


STR$ 


Rjnction STR$ converts a numeric expression to a string. 

SynUx STR$(N) 

where N is a numeric expression. 

Examples 10 A = 123.6 

20 B$ = STR$(A) 

Sets B$ = "123.6" 

10 A = 7.9M1E12 
20 B$ = STR$(A) 

Sets B$ = "7.941E12" 


Remarks This function permits the use of string operation on 
numoers . 

Exponential notation numbers are represented literally in 
string form. 


VER.V09F 


PACK 5-137 





BASIC FUNCTIONS 


SECnON 5.20 


5.20.12 Function 

STRINGS returns a string of a given length composed of 
similiar characters. 

Syntax 

A$ = STRING$(X,Y) 
or 

A$ = STRING$(X,Y$) 

The first version will return the string A$ with x 
characters of ASCII code Y. The second version returns with 
a string of the first character of Y$. 

Examples 

100 PRINT"PAGE HEADING” 
110 PRINT STRING$(12,”-”) 

Will output: 

PAGE HEADING 

Remarks 

The following statements are equivalent: 

A$ r STRINGS (5,65) 

B$ = STRINGS (5, "A") 

producing a string of five A ’s in AS and BS respectively. 
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SWAP 


5.20.13 Function SWAP exchanges the values of two variables. 


Syntax 

SWAP variable 1, variable 2 

Example 

this will put the value of variable A 
into B and the value of B into A. 

SWAP A$,BS this will put the contents of AS into 

B$ and the contents of BS into AS. 

Remark 

Any type of variables may be swapped (single precision, 
d^ble precision or string), but the two variables must be 
of the same type or a Type Mismatch error will occur. 
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TAB 


5.21.1 Function TAB moves the print position cursor the specified number of 
places from the left-hand margin. 


Syntax TAB(N) 

where N is the PRINT POSITION to begin PRINTING. 

Examples 100 PRINT"C0L 1 ";TAB(10);"COL 2";TAB(20);"C0L 3” 
Will print: 

COL 1 COL 2 C0L3 


Remarks In an LPRINT statement TAB specifies how many columns to 
skip before starting to print. 

If the value of the numeric expression is less than the 
print position, then TAB is ignored. The value of 
expression must be positive and not exceed 255. 
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TIME$ 


5.21.3 Function TIHE$ returns an eight character string with the time. It 
is used for reading and setting the software independent 
calendar clock. 


Syntax A$ = TIME$ 
OR 

TIMES = AS 


Examples 10 DIM AS(0,8) 
20 PRINT HMES 
30 AS = "10:5" 
40 TIMES = AS 


Remarks The eight character string is in the format hh:mm:ss. 

Leading zeros may be omitted, but, for example, if the 
minutes are zero, then one zero has to be entered. 

To enter the time directly type the following: 

TIMES="10:27" 

Seconds must not be entered as this will give a Syntax 
error. Seconds are set to "00" when setting the clock. 
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TRON/TROFF 


5.21.4 


Function 


TRON and TROFF traces the execution of 
displaying their line numbers. 


program lines by 


Syntax TRON 
TROFF 


Example TRON 
RUN 

[ 10 ] [ 20 ] [ 30 ] 


TROFF 


Remarks Line numbers are displayed in square brackets, but apart 
from this the program runs normally. The path of the 
program execution can be followed. TROFF turns off the 
trace facility. 
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5.24.1 Function 

WAID selects the bar code decoder to use. 

Syntax 

WAND=n 

Example 

WAND = 0 

selects the CODE 39 decode software. 

Remarks 

HUNTER can have multiple bar code decoder packages loaded. 
This ccximand selects the active decoder. 

Currently implemented are: 

0 - Code 39 

1 - EAN 8/13 

NOTE: It is essential to have the relevant decoder software 
loaded in the factory prior to attempting to use a wand. 
See section 8.5 BAR CODES AND LIGHT PENS for further 
information. 
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WHILE..WEND 


5.24.2 Function «HIU„..WEND executes a set of staten.ents If a condition 
Syntax WHILE numeric expression 


statements 


h> 


WEND 

'numeric expression* is evaluated true or false; if the 
statements following are executed. 
If false, the statement after WEND is executed. The loops 
WTOLE^ nested; each WEND associated with the most recer^ 


Examples 10 FOR Q=1 TO 10 
20 B(Q)=Q 
30 NEXT 

110 WHILE A< 11 
120 FOR I z 1 TO 10 
130 PRINT B(I); 

140 NEXT 

150 PRINT A:A z A+1 
160 WEND 

The matrix B is printed as long as the A parameter is less 
than 1 1 . 




Remarks Each time WEND is encountered the expression is re- 
evaluated. The same precautions should be exercised in 
jumping out of this loop as with F0R....NEXT loops. 

NOTE: WHILE cannot be used with a string expression. The 
statements WHILE and WEND must be on separate lines and no 
other statements must be on those lines. 
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WINCHR 


5.241.3 Function WINCHR inputs a single character from the optical wand. 

Syntax WINCHR N 

where N is a numeric variable. 


Examples 100 WINCHR N 
110 PRIW N 

This will input a single character from the bar-code wand 
and display it on the LCD screen. 


Renarks This function acts exactly like INCHR, but with the 
optional bar-code wand. The value Is returned from the 
bar-code exactly like a keyboard input. 

If a multiple character bar code is scanned then WINCHR 
will return the first character and the rest of the code 
will be ignored. 

As with WINPIJT if any key is pressed prior to the bar code 
input, then the input is taken from the keyboard instead. 

NOTE: The bar code format must first be selected using the 
WAND verb. The relevant wand firmware must be resident in 
HUNTER as a syster file. If it is not, then a system file 
error will result. 
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WINPUT 


5.241.41 Function WINPUT acts exactly like INPUT, but with the optional 
bar-code wand. 


Syntax WINPUT prompt, variable. (See also INPUT) 


Examples 100 WINPUT A$ 

110 PRINT A$ 

The bar-code wand input will be stored in A$ and displayed 
on the LCD screen. 


Remarks The string returned from the bar-code is read exactly like 
a keyboard input. If any key is pressed prior to bar-code 
input then the input will be taken from the keyboard 
instead. 

Further details of available bar codes may be found in 
section 8.5, BAR CODES AND LIGHT PENS. 

The use of string variables is recommended to allow for any 
alpha content. 

NOTE: The bar code format must first be selected using the 
WAND verb. The relevant wand software must be resident in 
HUNTER as a system file. If it is not, then a system file 
error will result. 
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5.24.5 Function 

WRITE# outputs data to file 

Syntax 

WRIIEIfile no,var1,var2, . . . .varX 

Examples 

WRITE#2,A$,B$,C 

Will write the variables A$,B$ and C to file number 2. 

Remarks 

The difference beteen WRITE# and PRINT# is that WRITE# will 
insert commas in the file between the items as they are 
written, while strings are delimited with quotation marks. 
WRITE# will not insert a blank before a positive number is 
written. 
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SECTION 6.1 


INTRODUCTION 


A principle feature of HUNTER'S architecture is its powerful and 
flexible communications facility. 

HUNTER can communicate freely with most other types of computer, 
from micros to mainframes, using a variety of easily selected 
communication 'Protocols'. These protocols, of both synchronous 
and asynchronous varieties, are chosen for compatibility with 
other systems and are not special to HUNTER. 

To establish communications, HUNTER uses the universally accep- 
ted RS-232/V2^ communications interface. This interface, used in 
virtually every computer system, terminal, printer and modem, 
allows HUNTER to 'plug in' to other systems without 
modification. 

HUNTER is equipped to act as a 'Data Terminal Equipment' (DTE), 
and together with appropriate protocol selections can resemble 
(partially emulate) many popular computer terminals. In this 
mode, it can be used as a portable computer terminal, accessing 
and communicating with other systems. 

Alternatively, HUNTER can act as a self-contained computer, 
directly supporting peripherals like printers without additional 
equipment. Remember that in this mode, HUNTER may need a 
'crossed cable' or 'modem simulator' to communicate with other 
terminal-equipped devices. 

HUNTER'S can communicate with each other, either side-by-side on 
the bench or over thousands of miles by telecommunication 
channels . 
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APPLICATIONS 


6.2 HUNTER'S communications can be used for transferring both 
programs and data to other systems. 

Programs can be loaded into HUNTER daily, or as required, from a 
central database. Secure protocols and program-based error 
checks can guarantee accurate copies. 

New, revised or corrected programs can be returned to the data- 
base for storage. Database files and command functions can be 
accessed automatically, or under manual control using HUNTER'S 
terminal emulation. 

Data can be collected and down-loaded to mainframe, minicomputer 
or microprocessor storage whenever required. Data transmissions 
can be formatted exactly to resemble existing data terminal 
configurations, allowing HUNTER to slot directly into existing 
software support structures. 

Database information (for instance, tables of names and 
addresses) can be sent to HUNTER for presentation to operatives 
in the field. Collected data can be linked to previously loaded 
database information for instant verification and validation. 
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6.3.1 


HARDWARE CHARACTERISTICS 


HfTERFACE CONNECTIONS 


‘"c >^unncui.ion5 may oe su 
6.1, EIA RS-232-C CONNECTOR SIGNALS, 


me connections may be summarised 




TABLE 6.1 EIA RS-232-C CONNECTOR SIGNALS. 


HUIfTER is configured as a -DTE' Data Terminal Equipment. 


Pin No. 

Description 

1 

Protective Ground 

2 

Transmitted Data 

3 

Received Data 

4 

Request to Send 

5 

Clear to Send 

6 

Datb Set Ready 

7 

Signal Ground 

8 

Data Carrier Detect 

9 

(Not used) 

10 

5v Power Out 

11 

(Not used) 

12 

(Not used) 

13 

(Not used) 

1i< 

(Not used) 

15 

Transmit Clock 

16 

(Not used) 

17 

Receive Clock 

18 

(Not used) 

19 

(Not used) 

20 

Data Terminal Ready 

21 

(Not used) 

22 

Ring Indicator 

23 

(Not used) 

2H 

(Not used) 

25 

(Not used) 


6.3.2 ELECTRICAL CHARACTERISTICS 

HUNTER'S output voltages on signals "from HUNTER" are guaranteed 
to be greater in magnitude then 5V when driving a 4K7 load in 
accordance with EIA specifications. Typically output voltaees 
are 8V in magnitude. ^ 
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HUNTER detects input signals with a ’’fail safe” characteristic. 
Input signals from -25V to +2.5V are detected as a logical ”1” 
or the mark state. Signals from +3.5V to +25V are logical ”0” 
or the space state. On the handshake signals the asserted state 
is spacing or logical ”0” e.g. CTS. 

To summarise, 

Output: 


Logical 

Logical 

Input: 

Logical 

Logical 


”0" or spacing 

Output > +5V with 4K7 load. 

”1” or marking 

Output < -5V with 4K7 load. 

”0" or spacing 

Input > +3.5V 

”1” or marking 

Input < +1.5V 


6.3.3 


Each input provides a line terminator impedance of 6K8. 

HTTERFACE POWER CONTROL 

Under normal circumstances the serial output interface is 
powered down to conserve battery life. The first character 
which requires transmission causes the interface to be powered 
up. A pause of approximately 2 seconds is allowed for the 
interface to settle down and then the character is sent. Further 
characters are not affected in this way. Once powered the 
interface is latched on until HUNTER is switched off or power 
removed using an OUT instruction in either Basic or machine 
code. 


When the interface is powered up it may cause spurious 
characters to appear to be sent out, causing problems with the 
receiving system. These may be overcome by powering the 
interface, prior to requiring the data, by sending any character 
as soon as HUNTER is switched on. A Basic LPRI NT command will 
achieve this. 


Alternatively, the interface may be controlled as follows: 
OUT 132,1 

will turn the interface on and 
OUT 132,0 

will turn the interface off. 
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If the interface is turned off after characters have been sent, 
then further characters will not cause the interface to be 
powered up and they will be lost. 

6.3.4 HANDSHAKE LINES 

The function of each of the handshake lines is described in turn 
section, with the exception of Ring Indicator 
(Rp. RI is provided to allow HUNTER to be switched on from an 
external source. 
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COMMUNICATION PORT SOFTWARE 


6.4 HUNTER'S communications format is software controlled. 

If HUNTER fails to communicate, always check the port 
initialisation for the correct format. 

6.4.1 INTITALISING THE PORT 

To initialise, or alter, HUNTER'S communications parameters as 
follows: 

From File Manager, 'COM3', or application program select 
'Initialise communications'. 

You are now in the communications program. All entries are 
menu-type choices, selected by the cursor control keys and 
confirmed by 'enter'. 

Values previously selected are displayed as the initial menu 
option presented. For instance, if '1200 baud' had previously 
been selected, then this option will appear after the heading 
'Rate'. 

HUNTER will prompt first for 'transmission parameters', followed 
by 'Receiving Parameters'. 

Specific parameters are modified by positioning the cursor with 
the cursor left, cursor right keys, and selecting the desired 
option with the cursor up, cursor down keys. 

NOTE: If the HUNTER has been totally reset for any reason, the 
parameters shown on entry to this program may differ from that 
expected. Extended use of the cursor keys will always correct 
any anomolies. 

6.4.2 TRANSMISSION PARAMETER SCREEN 


Transmission Parameters 
Rate-l800 Prtcl-none Pty-none 
CTS-n DTR-n LF-n Echo-y T/O-no Null-0 

press ENTER if acceptable 
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6.4.3 RECEIVING PARAMETER SCREEN 


I Receiving Parameters 

I 

I 

I Rate-1200 Prtcl-none Pty-none 
I RTS-off DSR-n DCD-n T/O-no Serig-off 

I 

I 

I press ENTER if acceptable 


To re-select the previous entries, press 'ENTER'. 

6.4.4 BAUD RATE (Rate) 

The available baud rates are:- 



1200 

75 

1800 

110 

2400 

150 

4800 

300 

EXT 

600 



The EXT feature is to provide for external clocking when using 
synchronous protocols. 

6.4.5 SELECT PROTOCOL (Prtcl) 

The protocols available on HUNTER are:- 

NONE Systime 

XON/XQFF IBM 2780 (optional) 

ACK/NAK 

ETX/ACK 

6.4.6 SELECT PARITY (Pty) 

On transmission parity is implemented as follows: - 

a) None bit 8 is reset, i.e. logical 0. 

b) Odd bit 8 is set or reset to cause an odd number 

of logical 1's in the data bits. 

c) Even bit 8 is set or reset to cause an even number 

of logical 1's in the data bits. 
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d) 8-bit All eight bits are transmitted with no mod- 

ification. This may be used to transfer binary 
information. 

On reception the implementation is:- 

a) None Parity bit is ignored and set to logical 0. 

b) Odd or Even The data is checked for an odd or even number of 

logical 1's. If the check fails then the 
character is received as 255 decimal (OFFH). 

c) 8-bit All eight bits of data are passed to the calling 

program. 

NOTE: The parity fail character (OFFH) is displayed as 4— on 
the screen. 

6.^4. 7 HANDSHAKING LINES 

There are handshaking lines provided on the RS-232 port. These 
signals are usually used when operating with a modem. The lines 
conform to the standard RS-232 specification for use with 
modems, for specific applications lines need to be enabled as 
appropriate. In general, a straight 25 way cable will operate 
with most modems. They may also be used when communicating with 
e.g. printers or for the HUNTER to hold up 
incoming data. These lines will be discussed in turn. 

6.44.7.1 CTS pin 5 (Clear to send) input to HUNTER. 

transmit menu, controls data being 

If selected (y) then cnly If the line is active (+ve) will data 
0 ^™?.^,“®“- t®"ted at thrstlrt Of each 

of each block in sync Data 
^ completely transmitted even if CTS goes 

If^deselected (n) then this input is ignored and data is always 

RTS pin 4 (Request to Send) output from HUNTER. 

RTS flag, see section 9.7, MEMORY LOCATIONS. The th?^ee model 


6. 4. 7.2 
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a) OFF When this option for RTS is selected the RTS line 

is permanently active (+ve) and its state is not 
altered at any time during communications. 

b) HOLD In this mode the RTS line is normally active 

(+ve) and only goes inactive (-ve) when HUNTER 
has received too many characters and the receive 
buffer is about to overflow. This mode can thus 
be used to hold up a transmitting device until 
HUNTER has removed enough characters from the 
receive buffer such that there is enough space in 
the buffer to allow the transmitting device to 
send more data by raising RTS to active (+ve) 
again. This mode can be used when communicating 
HUNTER to HUNTER via a crossed cable. If a 
synchronous protocol has been selected, RTS 
should not be set to HOLD. 

c) TRUE This mode of RTS is meant for handshaking with a 

MODEM or similar device. When HUNTER wishes to 
transmit data, it first of all raises RTS from 
inactive (-ve) to active (+ve). Then HUNTER 
waits for a reply on the CTS line (if enabled) 
before sending the data in the transmit buffer. 
RTS remains active until all the data has been 
sent and the buffer is empty, then HUNTER returns 
RTS to the inactive state (-ve). 

6. 4. 7. 3 DCD pin 8 (Data Carrier Detect) input to HUNTER. 

This signal, selected on the receive menu, is used to tell 
HUNTER that received data is valid. 

If selected then only when the signal is active (+ve) is data 
received normally. 

If DCD is inactive then no data will be received, even if the 
data input line has data on it. 

6. 4. 7. 4 DSR pin 6 (Data Set Ready) input to HUNTER. 

This signal, selected on the receive menu, is used to tell 
HUNTER if the peripheral (usually a modem) is ready to operate. 
If selected, only if DSR is active will HUNTER communicate in 
both directions. 

If DSR is inactive then HUNTER will not transmit or receive 
data. This signal can be ignored by selecting ”n" on the receive 
menu. 
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6.4.7.S 

DTR pin 20 (Data Terminal Ready) Ouptut from HUNTER 

This signal, selected on the transmit menu, is provided to 
enable modems that require DTR to be present before generating 
carrier. 

If selected (DTP-y), DTR will go to the active (+ve) state if 
either transmission or reception is attempted from the HUHTTER. 

If not (DTR-n), DTR will only be active If transmission 

from the HUNTER is attempted. 

DTR can also be controlled by the communications power supply 
port 132 (see section 9.8), INVCON. DTR is active when the 
inverter is on. 

6.4.8 

Timeouts 

6.4.8.1 

timeouts are provided to signal to user 
f communications lines are quiescent. Separate 

^ tI “^/-selectable for both transmit and reVeive 
ONCOMM^ timeouts are designed for use with the Basic 

ONCOMMS statement (see section 5.16.3), but can also be invok^ 
manually or by machine code programs. The error number is 
available in the location COMERR (see section 9.7, page 9-38). 

The timeouts have a range of 10-60 in ^ 

SMtlon lo'=®tlons RXTOAF and TXT0AF*?«f 

to hv ^ ^ 9-38). These locations can be read or written 

RXTOAF 

6.4. 8.2 

Will cause a ’communications error’ ^ i u 

quiescent for more than the selected period^ R^pnf? 
character, or noise, will reset thp any 

initiated by a request for serial lnno7 h 4 - 1 ^® timeout is 

'LINPUT' or similar statement ^ ^ through a Basic 

the in^t co™icationa buffer', the U^c^tTll U' «cur.''®"'' 
TXTQAF 

Will cause a 'communications error' if the HUNtpr s < u w 
HU^R, a ■communlcatlona error- will occur aae^'C IpTlffed' 


VER.V09F 


PAGE 6-10 


COMMUNICATIONS 


SECTION 6.^1 


6.4.9 

Echo 

The 'echo flag', ECHOF (see section 9.7, page 9-37) determines 
whether transmitted characters are echoed on the HUNTER screen. 
Data transmission and reception are not affected and the 
displayed characters are not passed to user programs or entered 
in the receive buffer. 

Echo can be regarded as a full/half-duplex selection, with 
duplicate characters appearing on the screen if the HUNTER is 
communicating with a full-duplex host with echo 'on'. 

6.4.10 

LF 

The line feed flag, LFACT (see section 9.7, page 9-37) 
determines whether a LF character (decimal 10, Hex 'OA') is 
inserted in the data stream transmitted by HUNTER automatically 
following every CR (Decimal 13, Hex 'OD') in the transmitted 
text. 

If selected, on (LF-y), line feeds are inserted after CR even if 
line feed characters are already present in the data. 

If selected, off (LF-n), line feeds are not inserted. However, 
line feeds present in the data will be transmited. 

NOTE: When sending binary data, the LF-y option will insert LF 

characters if the data contains decimal 10, even if the decimal 
10 character is not intended as a CR. Always select LF off (LF- 
n) if using 8-bit transmission. 

6.4.11 

Null 

The Null count is provided in the transmission set up for use 
with printers that have a significant carriage return delay and 
when no handshaking or buffer is available. 

If selected, NULL inserts NUL (Decimal 00) characters in the 
data stream after CR (and LF, if selected with the LF-y option). 

The number of nulls is chosen from 0,2,5,10 or 20. these 
options are provided by the HUNTER operating system and cannot 
be varied. 

NOTE: If transmitting binary files in 8 bit mode, null must be 
selected off (Null-0), since it will otherwise insert Null 
(Decimal 0) characters after every CR (Decimal 13) character. 
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SERIG (Receive channel only) 

The SERIG location (see section 9.7| page 9-38) allows any 
single character in the range 0 - 127 Decimal CO’ - '7F' Hex) 
to be ignored by HUNTER'S serial data reception system. 

Characters rejected by SERIG are not entered in the 
conmunications buffer or passed to user programs. 

SERIG is provided for use with computer systems that provide 
abundant spurious characters (e.g. XON or DEL) as part of data 
streams. Since filtering these unwanted characters can be 
inconvenient in user programs, SERIG provides a useful solution. 

The value of SERIG is selected by incrementing/decrementing the 
decimal value using the up/down cursor keys and must be set to 
'OFF' when not in use. Serig-off is obtained by incrementing 
past 127 or below 0. 
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ASYNCHRONOUS CHARACTER HANDLING 


^•5.1 HUNTER'S asynchronous serial data communications are handled by 

a communications software package totally separate to the user's 
program or the Basic interpreter. 

The user needs no detailed knowledge of data communication to be 
able to utilise HUNTER'S powerful facilities. The required con- 
figuration is selected from 'menus' and operation of the package 
is virtually invisible. 

6.5.2 BUFFERS 

Characters are transferred to and from the serial interface via 
invisible 'buffers' that effectively disconnect the application 
program from the outside world. TTiese buffers ensure a smooth 
flow of data and correct reaction to protocol responses even 
when HUNTER is busy doing something quite different! 

Because the communication package is interrupt driven, the 
execution of user programs is not affected by communication. 
However, the user program may slow down if the serial line is 
busy. HUNTER'S communication buffers are available whenever the 
machine is powered up, even if the application program is not 
requesting communication. Incoming messages will be received 
and held in the buffer, while any outgoing data remaining will 
continue to be sent down the line. Any protocols selected will 
continue to be observed. 

6.5.3 COHHUNICATING WITH USER PROGRAMS 

A user program can transmit and receive characters either singly 
or in blocks. The program may be written in HUNTER BASIC (see 
LPRINT, UNCHR, etc) or a compiled language using the standard 
CP/M calls. 

Irrespective of the content of the user program, all data rates, 
protocols and other selections previously made will be observed 
invisibly by HUNTER'S communication software package. 
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6.5.3. 1 Transmission 

When transmitting, HUNTER writes the characters into a buffer. 
If the buffer becomes full, then the user program (BASIC or 
CP/M) is held up until the characters or block are sent. 

If a ’communication failure' is detected, execution of the user 
program will be suspended until manually overridden. 


6. 5.3.2 


Receivir^ 

When receiving characters, data receiving commands (LINCHR and 
UNPUT in Basic) will fetch any characters or blocks currently 
held in the reception buffer. 

NOTE: This data may have been received prior to execution of the 
input command 

If data is already in the buffer, then it will be returned 
immediately. If no data is present, HUNTER will wait for 
incoming data, and will return when characters or blocks are 
available. 


Reception of data is completely transparent to the user Basic 
program being run by HUNTER. Data may be sent at any time to 
HUNTER, communications protocols being implemented as selected. 


Use is made of a 256 character input buffer. Received 
characters are placed into the buffer in a 'barrel' fashion. If 
more characters are received than this, without any being read 
by a calling program then the earliest characters are 
overwritten. This is true even if RTS or XON/XOFF handshaking 
is used and is ignored by the sending device. 


The effect of this buffering is to permit reception of 
characters to carry on steadily through calling programs which 
intermittently. 11,13 c/n a greeted 


The buffer is needed 
protocols. 


by definition for the XON/XOFF and 


ETX/ACK 
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6.6.1 



ASYNCHRONOUS PROTOCOLS 


NOTE: In this section, 'host' means the device communicating 
with HUNTER, whether it be computer, printer, modem or 
otherwise. 

These protocols may be used by Basic application programs, user 
assembly code, CP/M programs or directly in 'Terminal Emulation' 
mode. 

NONE 

RECEPTION 

As Implied, this selection does nothing to control the incoming 
data. It behaves as a simple teletype. Characters are placed 
into the reception buffer and a calling program may read them 
out asynchronously. 

TRANSMISSION 

Each character is transmitted as the calling program requests it 
(except when waiting for the previous character to be sent). 
There is no buffering of the output data. 

XON/XOFF (DC1/DC3) 

RECEPTION 

If an incoming character causes the receive buffer to have 90 or 
more unread characters then an XOFF character (DC3, 19 Decimal or 
Control S) is transmitted, which should prevent the host sending 
further characters to HUfTTEP. 'Then the buffer is reduced to 10 
pending characters, an XON (17 Decin.al or Control Q, DCl) is 
transmitted to re-enable the host to HUNTER transmission. 
Subsequent XONs or XOFFs are never transmitted without an 
intervening XOFF or XON respectively. 

TRANSMISSION 

The input data line is also examined for XON or XOFF characters. 

If an XOFF or stream of XOFFs are received then transmission is 
stopped as soon as the character being transmitted is finished. 
The protocol requires an XON to restart transmission. This 
protocol procedure strips 'XON' or 'XOFF' Control characters, 
thus returning only valid data. 

SLAVE, HUNTER TO HOST TRANSMISSION 

TRANSMISSION 

It should be noted that following the host transmitting an XOFF, 
it is possible, depending on data link speed, to have a further 
two characters sent out by HUNTER. This is due to the time 
taken to receive the XOFF and the possibility of just missing 
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6.6.M 


6.6.5 


SLAVE, HUNTER TO HOST TRANSMISSION 
TRANSMISSION 

It should be noted that following the host transmitting an XOFF, 
it is possible, d^ending on data link speed, to have a further 
two characters sent out by HUNTER. This is due to the time 
taken to receive the XOFF and the possibility of just missing 
the start of the next character. 

At the start of transmission a received XON is assumed, to avoid 
lock-up. 

ETX/ACK 


RECEPTION 

In this protocol HUNTER will send an ACK character (06 Decimal 
or Control F) after reception of an ETX character terminating a 
line that has been ready by Basic. The ETX is stripped from 
incoming data and not sent to Basic. This protocol causes the 
host device to wait at the end of each block of data, which 
should not exceed 130 characters, for an acknowledgement that 
the block has been read. The ETX/ACK acknowledgement is only 
transmitted when the block has been fetched from the buffer by 
Basic. 


THANSMISSION 

This protocol will send out an ETX (03 Decimal or Control C) 
character after any transmitted carriage return. Transmission 
is then halted until an ACK (06 Decimal or Control F) is 
received from the host. This enables individual data blocks to 
be sent a^ an acknowledgement awaited. If transmission is to 
another HUNTER the blocks should not exceed 130 characters or 
the input buffer may be exceeded. If an ACK is not received 
within thirty seconds then communication failure is assumed and 
an error message is put up on the screen. 

The ACKs are not returned to the user program. 

% the very nature of this protocol, indeterminate handshaking 
?™sslon!"^'' ““"-lltlons are altered during 


ACK/NAK 

RECEPTION 

In this mode HUNTER will receive a complete block of dai-a 
return. It will then check for 
parity errors. If one exists then a NAK (?1 Decimal or Control 
U) is sent out to the host and the data block ignored. 
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If the block is error-free then the received block is sent 
character by character to Basic. When the carriage return is 
sent to Basic an ACK (06 Decimal or Control F) is sent out to 
the host to indicate successful data block reception. 

TRANSMISSION 

Data blocks are first placed into a transmission buffer. Upon 
receipt of a carriage return from Basic, the entire buffer is 
transmitted. HUNTER then awaits an acknowledgement. If an ACK 
is received then the next data block is assembled into the 
buffer and sent. If a NAK (21 Decimal or Control U) is received 
then a failure is indicated and the entire buffer is sent again. 
If nothing is received after three seconds a NAK is assumed and 
the buffer sent again. The NAKs may be sent a maximum of three 
times. If an ACK is still not received then the communications 
failure message is put on the screen. 

6.6.6 SYSTIME 

6.6.6. 1 HUNTER to Systine communications Protocol Specification 

This protocol is provided to facilitate communication between 
HUNTER and Systime model S500 minicomputers. The protocol 
embodies a checksum in addition to parity checks. 

Data is sent in the form of messages which are subdivided into 
one or more fixed length blocks. Each block is individually 
checked and acknowledged before any further blocks are sent. 

DATA BLOCKS 

Each block consists of:- 

1 start character 
64 data characters 
3 checksum 
1 stop character 

The purpose of each character group is as follows:- 


The first block of a message uses SOH (01 Decimal). Further 
blocks use STX (02H) as the start character. 


The last block of a message uses EOT (04 Decimal), previous 
blocks use ETX (03H) as the stop character. 
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Data Character 

The data characters may consist of any 7 bit pattern with the 
exception of the handshake characters : ACK (06 Decimal), NAK 
(15H) and WACK (13H). 

Checksum 

The checksum is formed as the modulo 256 addition of all data 
characters, with parity reset. The number formed is transmitted 
in ASCII as three decimal digits. Leading zeros are not 
suppressed. The most significant digit is sent first. 

Insufficient Data Characters 

If there are less than 6^ characters for the data block, then 
the remainder of the block is filled with NULLS (00 Decimal). 
The characters are ignored on reception. 

Handshaking 

Each block of data must be acknowledged by the receiving device. 
After a successful reception and if the receiver is ready to 
receive another block, then it returns an ACK (06 Decimal). If 
the transfer is deemed unsuccessful for any of the following 
reasons:- 

1) parity fault on any character 

2) Incorrect start or end characters 

3) wrong number of characters 

4) checksum error 

5) timeout (waiting for characters for 4 secs) 

then a failure is returned as a NAK (21 Decimal). 

If the receiver accepts the block, but is not ready for further 
data, then a wait acknowledge WACK (19 Decimal) character 
delaying the transmitter's time out is transmitted. Further 
delays can be accumulated by transmitting WACK's at the rate of 
one every 2 secs. The message is finally accepted with an ACK. 

COMMUNICATIONS FAILURE 


If a failure occurs on transmission and a timeout activates 
then HUNTER will display 'Communications Failure' on the top 
line of tlw display. This message may be overriden by pressing 
X on the keyboard. This will force transmission for ETX/ACK 
or XON/XOFF; in the case of ACK/NAK then the buffer will be sent 
another three times. 


A timeout can be prevented from occurring after 
failure by re-initialising the communications. 


transmission 
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SYNCHRONOUS PROTOCOLS 


provide the fast, high integrity communication required by 
most mainframe computers, HUNTER has a synchronous data 
communication capability. 

^mmunication takes place using synchronous transmission of data 
blocks. These blocks are checked using check characters and 
acknowledged as appropriate using particular protocols. 

Currently available as a factory option is the IBM 2780* 
communication protocol providing the bisynchronous 
communications. Other protocols are in development. 

6.7.1 IBM 2780 ON HUNTER 

BACKGROUND 

The IBM 2780 is a very popular data transmission terminal used 
for remote job entry. The transmission protocol developed for 
this device has been widely implemented on other mainframes to 
the extent of becoming a de facto industry standard. HUNTER'S 
implementation mimics 2780 protocol to provide well proven, fast 
and extremely reliable data transfers. 

IBM 2780 is used for batch entry by use of "job cards". HUNTER 
is easily programmed to simulate the use of job cards providing 
all the processing facilities normally available on a remote 
terniinal . 

HUNTER is the most advanced portable to offer a comprehensive 
implementation of IBM 2730 in true synchronous mode. 

ADVANTAGES 

This well proven and sophisticated protocol gives HUNTER 
reliable, high speed communications over relatively poor data 
links such as the public switched telephone network at speeds as 
high as 2400 baud. 

Use of this standard provides access to a wide range of 
mainframe computer systems, directly and without need for 
supporting equipment. Data files can be exchanged between 
HUNTER and mainframe with great flexibility, convenience and 
dependability. 


»NOTE: IBM and 2780 are registered trademarks of IBM Corp. 



COtWNICATIONS 


SECTION 6.7 


6.7.2 


6 . 7 . 2. 1 


TABLE 6.2 TECHINCAL IMPLEMENTAnON 

: Synchronous transmission using Bisync. 

: Character set - EBCDIC 

: Full CRC generation, error handling and flow control. 

: Modem handshake lines available. 

: Internal or external clocking options. 

: May be used over the public switched telephone network or 
private lines. 

: Records terminated using the EM character, providing optimum 
throughput. 

: The "Wait acknowledge" is fully implemented. 

: Protocol use is completely transparent to user programs. 

: Data Rates - up to 9600 Hz with external clocking. 

- up to ^800 Hz using internal clocking 

The internal self-synchronising feature enables HUNTER to HUNTER 
communications over standard 300 baud asynchronous modems. 

SYNCHRONOUS COMMUNICATION 


Synchronous communication transfers data as a continuous stream 
of data characters, without the need for start and stop bits as 
used in asynchronous communication. This maximises the data 
transfer rate for a given channel bandwidth. For the receiver 
to be able to use the data two levels of synchronisation need to 
take place: 

i) Bit Synchronisation 

This allows the receiver to save the state of each bit 
correctly, preferably sampled at the centre of each bit. 

ii) Character Synchronisation 

Each block of eight bits which represent a character needs 
to be identified from within the data stream. 

Bit Synchronisation 

Two techniques are used by HUNTER to achieve bit 
synchronisation. 


External Clocking allows both transmit and receive to be 
synchronised using two independent clocking signals. These 
signals are generated by either a modem or modem eliminator. 
The selection CLK' on the speed selection of transmit or 
receive menus selects this mode. 


Two pins are provided for the clock signals, 
the transmit clock and pin 17 the receive clock. 


Pin 15 provides 
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On transmit, a rising edge (-12V to +12V) causes a bit to change 
on the transmit output (pin 2). On receive, a falling edge 
(+12V to -12V) causes the state of the receive input (pin 3) to 
be sampled. 

It is important that maximum clock speed on HUNTER should not 
exceed 9600 Hz (giving a data rate of 9600 baud). The minimum 
speed is approximately ICOHz. 

Exceeding this clock rate may cause unpredictable results. 

Alternatively, HUNTER can self clock. This is achieved by 
selecting from the menu the desired transmit and receive baud 
rates in the range 50-4800 baud, as for asynchronous. On 
transmit, the data is sent out by using internal timing, with no 
reference to any external clock source. 

To receive incoming data HUNTER times from rising edges (-12V 
to +12V) on the receive data line to give internal clocking. 

Self clocking is useful for HUNTER - HUNTER communications. It 
may be used over asynchronous modems to provide both increased 
throughput and data integrity. 

6.7. 2.2 Character Synchronisation 

To be able to extract eight bit data characters, HUNTER has to 
synchronise itself to the incoming characters correctly. This 
is done by detecting special synchronising characters called SYN 
character^ (32H). HUNTER considers synchronisation to have been 
achieved after receiving two contiguous SYN characters. 

After receiving the two synchronising characters each group of 
eight received bits are then considered to be a character. 

Synchronisation is considered to have been lost if a line 
turnaround character is received (CFFH). This is equivalent to 
an open line. 

Prior to sending the synchronising characters, HUNTER transmits 
an OAAH pad character which is to assist in bit synchronisation. 

Every data block whether it consists of one or 500 characters, 
must start with a pad character, and two SYN characters and 
terminate with line turnaround. 
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6.7.3.1 


6.7.3.2 


6.7.3.3 


BINARY SYNCHRONOUS COMMUNICAnONS (BSC) 

The information carrier for 2780 is the binary synchronous 
communications (BSC) procedure. The character set used is 
EBCDIC (Extended Binary Coded Decimal Interchange Code). The 
following is a description of the subset of BSC used for HUNTER 
2780 eoulation. 


NOTE: HUNTER generally operates using the USACII (United States 
of America Standard Code for Information Interchange). Charac- 
ters either transmitted or received by Basic will be in ASCII, 
so CHR$, LOPCHR, etc., instructions all generate ASCII charac- 
ters. To use EBCDIC the 2780 driver software utilises an ASCII 
to EBCDIC and EBCDIC to ASCII code converter. The conversions 
used are listed in section 9.11, ASCII TO EBCDIC CONVERTION. 

The code used on the transmission channel is transparent to 
Basic programs, and need not concern the programmer. 

Text Blocking 

BSC defines general structural procedures for the blocking of 
information. Several control characters are used for the 
control of message blocks. 


A message consists of one or more blocks of text data. The 
start of text character (STX) is used immediately preceeding 
each block of data. Each data block but the last is terminated 
by an end of transmission block (ETB) character or an 
intermediate text block (ITB) character. The last data block 
ends with an end of text (ETX) character. 

Error Checking 


Each block of data is error checked by the receiver by a cyclic 
redundancy check (CRC). After each transmission the receiver 
normally replies with ACKO or ACK1 - data accepted continue 
sending; of with NAK - data not accepted (e.g. due to a data 
transmission error), retransmit the previous block. 

CRC-16 


HUfTTER uses the accepted error checking method of EBCDIC 2780 
The cyclic redundancy check is a division at both the 
transmitting and rweiving stations using the numeric value of 
the message as a dividend, divided by a constant. The quotient 
is discarded and the remainder is used as the check character. 
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This is transmitted imuediately following an ITB, ETB or ETX. 

The receiver checks this value and finds no error if they are 
equal. 

CRC-15 uses the polynomial (x^^+x'^+x^+l ) as the divisor 
constant. The 16 bit remainder is sent as two eight bit 
characters. This is also sometimes referred to as the BCC 
(Block Check Character). 

6.7.3.4 

Line Bid 

For either HUNTER or base computer to transmit a message, the 
line must first be seized. This requires sending an enquiry 
(ENQ) character. A positive acknowledgement permits Uie start 
of a message. 

6.7.tt 

LINK CONTROL CHARACTERS 

The data link is controlled by the use of the following control 
characters: 

6.7.'^.! 

STN (32H) - Synchronous Idle 

This character is used to establish synchronisation. Two 
contiguous SYNs are required for synchronisation. They may also 
be used as pad characters, although never used as such by 
HUNTER. Syncs will be ignored after synchronisation has been 
established except as part of CRC. 

6.7. «. 2 

STX (02H) - Start of Text 

This character is used as the start of text preceeding all text 
blocks. It is not part of the CRC accumulation. 

6. 7.^.3 

ETB (26H) - End of Transmission Block 

The ET3 character indicates the end of a block of data 
characters. A block check character is sent immediately 
following an ETD. A reply is required after an KTB (ACKO, NAX, 
etc). 


ITB (1FH) - End of Intermediate Transmission Block 

ITB is also called lUS or US (Unit Separator). This enhances 
the throughput due to not having to go through a line 
turnaround. The CRC accumulation is reset after an ITB. It is 
not necessary to send an STX after the ITB. 

VER.V09F 

PAGE 6-21 



CCmJNICATIONS 


SECTION 6.7 


1 6.7.M.5 

If the error check fails then a NAK is sent at the end of the 
transmitted message, i.e. after the ETB or ETX. The whole of 
the message is retransmitted in the event of a NAK being the 
reply to a complete message block. 

ETI (03H) - End of Text 

ETX is transmitted after a block of characters started by an 
STX. The CRC is sent immediately after an ETX. A reply is 
required to indicate the receiver status. 

1 6.7.^. 6 

EOT (37H) - End of Transmission 

This character terminates a message transmission containing a 
number of blocks. It is also used to indicate a system 
malfunction. 

1 6.7.M.7 

ENQ (2DH) - Enquiry 

ENO is used as the line bid to start a transmission sequence. 
ENQ is also used to obtain a repeat transmission of a response, 
in the case of a garbled response. 

1 6.7. ^.8 

ACKO (10H,70H) - Affirmative Acknowledgeoient 

This is one of two positive acknowledgements to error checked 
message buffers. This informs the transmitting station that the 
message was received satisfactorily. This acknowledgement is 
also used to confirm a request for the line. ACKO alternates 
with ACK1 positive acknowledge. 

Alternating Affirmative Acknowledgement 

Alternating ACKO and ACK1 provides sequential checking of 
replies, this ensures that the blocks are replied to correctly. 
ACKO is used as the response to a line bid. 

It should be noted that ACKO and ACKl consist of two 8 bit 
characters. 

6.7.^.9 

ACKl (10H,61H) - Positive Acknowledge 

This is the alternate acknowledge. It is used with ACKO to 
respond correctly to incoming messages. 

6.7.^. 10 

VACK (10H,1CH) — Walt Positive Acknowledge 

A receiving station that has correctly received a message but is 
not yet in a condition to use the data, can send a WACK. It is 
a positive acknowledge. The transmitting station should then 
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6.7.4.11 

= two character sequence, 
mrther ^ ~ *top 

NAK (15H) - Negative Acknowledge 

reoefv^d' in^“e?rnr'’® ‘''““"tttlng station that a message 
erroneous restage. retransmission of the 

6.7.4.12 

DLE (10) - Data Link Escape 

Data link escape is used to provide various line control 
characters, e.g. WACK, ACKO, ACKl and RVI. control 

6.7.4.13 

RVI (1GH,7CH) - Reverse Interrupt 

0 tacVtVAaS"o 7 tWA acknowledgement (in 

V requests termination of the 

sPiI^T ^ ^ priority message needing to be 

sent from the receiving station. s uc 

6.7.4.14 

HUNTER will never generate an RVI but will respond to one. 

DLE EOT (10H,04H) - Disconnect Sequence 

Ihtttitt!'’dtIIS* '•e=ei''er that the transmitter is 

6.7.4.15 

IRS (lEH)'- Intermediate Record Separator 

® 3780 configurations. 
Reception of this returns a CR (carriage return). 
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6.7.5 MESSAGE TRANSMISSION 

The following Illustrate various message sequences and error 
handling. 

NOTE: TX = Transmitting station. RX = Receiving station. 

Fig 6.1 NORMAL HESSAGE 


TX 


RX 


ODD 

S E 

T (TEXT) T 
X B 


EVEN 

S E 

T (TEXT) T 


S E 

T (TEXT) T 


Fig 6.2 UNANSWERED LINE BID (ERROR 01) 


TX E (3 sec bid 
N timeout) 

Q 


E (3 sec bid 
N timeout) 

Q 


E Number of 
N retries 


NOTE: HUNTER will retry for a total of 10 ENQs. Many mainframe 
systems never give up. 


Fig 6.3 ACCEPTED RE-TRANSMISSIONS 


TX 


S E 

T(TEXT-A)T 


ODD 

S E 

T(TEXT-A)T 
X B 


EVEN 

S E 
T(TEXT-B)T 
X B 


RX 
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Fig 6.4 RE-TRANSMISSION 

REJECTED (ERROR 03) 



ODD 


ODD 

ODD 

E 

S E 


S E 

S E 

TX N 

T(TEXT-A)T 


T(TEXT-A)T 

T(TEXT-A)T 

0 

X B 


X B 

X B 

RX A 


N 

N 


C 


A 

A 


K 


K 

K 



0 


NOTE: Number of re-trys can vary. HUNTER will retry 10 times, 
but some mainframe systems will retry indefinately. 


Fig 6.5 


E 

TX N 
Q 

RX A 
C 


0 


TRANSMISSION DELAY (RECEIVER INITIATED) 



ODD 


EVEJI 





S 


E 

S 

E 


E 


T 

(text) 

T 

T (text) 

T 


N 


X 


B 

X 

B 


Q 




A 



V/ 


W 



C 


(2 sec 

A 

(2sec 

A 



K 


int) 

C 

int) 

C 



1 



K 


K 


E 

N 

Q 


ODD 


O 

T 

X etc. 


A 

C 

X 

1 


NOTE: HUNTER does not count WACK-ENQ sequences. The receiver 
buffer may be cleared. 
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Fig 6.6 TRANSMISSION DEUY (TRANSMITTER INITIATED) 


TX 


S E T T S E 
T (TEXT) T 2 SEC T 2 SEC T T (TEXT) T 
X B INTERVAL D D X X 


NOTE: HUNTER does not count TTD/NAK sequences or generate TTDs. 
Fig 6.7 STX LOST AND DATA IGNORED 

EVEN 


S E 

T(TEXT B)T 




ODD 

EVEN 



E 

S 

E 

E E 

n 

N 

T(TEXT 

A)T(TEXT B) 

T (3 SEC N 


Q 

X 

B 

B TIMEOUT )Q 

RX 

A 


A 

NO RESPONSE 


C 


C 



K 


K 



Fig 6.8 INCORRECT POSITIVE ACKNOWLEDGEMENT (ERROR 03) 


TX 


RX 


SEE 
T(TEXT A)T(TEXT B) T 
X B B 


NOTE: HU^iTER will send 10 ENQs before giving up. 
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6.7.6 


6.7. 6.1 






v;t V ^ 



Fig 6.9 DATA LINK ABORTION ON NO RESPONSE 

(ERROR 02) 


E S 

E 

E 


TX 

N T (TEXT) T (3 SEC RESPONSE 

N 

(3 SEC TIME 


Q X 

B TIMEOUT) 

Q 

OUT) 

RX 

A 

NO RESPONSE 


NO RESPONSE 


C 





K 





0 




NOTE: 

HUNTER sends out 10 ENQs. 



Fig 6.10 DATA 

LINK STALEMATE 




E 

S E 



TX 

N 

T (TEXT) T NO COmNUAnON 


Q 

X B 



RX 


A A 




NOTE: Failure to receive further messages could be timed out by 
the Basic applications program. 

HUiriER/2780 SPECIFIC IMPLEMENHON FEATURES 

The foregoing describes in general operations on the 
communications line for 2780 protocol. HUNTER has particular 
features and handling which may be important to users. 

Buffer Operation 


To implement this synchronous protocol it is necessary to use 
buffering on transmit and receive so that error checking and 
re-transmission can be performed. 


VER.V09F 
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and receive, the operation of which is described below. 
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6.7.6. 1.1 TVansmit Buffer 

On transmit while one buffer is being filled from the user 
program the other is being sent. When the new buffer is full 
the buffers effectively swap over and the cycle is continued: 


Fig 6.11 TRANSMIT BUFFER 


Characters 



Characters 


Buffer A is filling whilst buffer B transmits. 


Characters 


Basic 


Buffer A 

1 


Prog 



Transmitting 

Sending 

1 


Software 

Characters 

Buffer B 




Communication 

Channel 


Characters 


ajffer B is filling whilst Buffer A transmits. 

The maximum buffer length, including control characters, that 
can be received is ^2 characters. However, some systems are 
only configured for 256 characters. For this reason HUfHER will 
facing^^'^^^ transmitting 200 characters for ease of inter- 
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Fig 6.12 RECEIVE BUFFER 



Filling buffer A, emptying buffer B. 





Filling, buffer 3, emptying buffer A. 


As with the transmit buffer arrangement, one buffer is being 
filled from the communications line while the other is being 
emptied by the user program. 


6. 7. 6. 2 Data Format 

HUNTER is able to accommodate 2780 protocol as both fixed and 
variable block lengths. Also, 3780 is accommodated. 

It is possible to configure the bisync emulator to provide very 
flexible interfacing for a variety of different host machines. 

Standard configurations can be made for: 

a) 2780 with variable record length 

b) 2780 with fixed record length 

c) 3780 

The block sizes and record sizes can be adjusted for 
compatibility and maximum throughput on the communication 
^ channel. 
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Other features which are available for special purposes are: 

a) Intermediate STX 

b) Single record blocks 

c) Space compression 

Features not implemented are: 

a) Transparency 

b) Multi drop 

All features are discussed in detail later. Although they may 
all be selected individually, they may not make a compatible 
protocol. Standard configurations are as follows: 

6. 7. 6. 2.1 2780 with variable records 

(This is the default configuration) 

a) Record length = 80 

b) Block length = 200 

c) Multiple records per block 

d) Record Padding disabled 

e) No intermediate STX 

6 . 7 . 6.2. 2 2780 with fixed length records 

a) Record length = 80 

b) Block length = 200 

c) Multiple records per block 

d) Record padding enabled 

e) Intermediate STX enabled 

6. 7. 6. 2. 3 3780 

a) Record length = 80 

b) Block length =512 

c) Multiple records per block 

d) Record padding disabled 

e) No intermediate STX 

Space compression is only normally used in 3780 installations. 

6. 7 . 6. 3 HUNTER Card Format 

Virtually all HUNTER data is delimited by CR (carriage return). 
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1 


Blocks of data loaded by LINPUT statements are terminated by CR, 
as are lines of printout. The most straightforward method of 
block creation is to treat data between CRs as cards of data. 

6. 7. 6. 3. 1 Transmitting Cards 

^ transmit, if a CR is detected in the data, the communication 
software will treat it as a record end. The action taken 
depends upon the amount of room left in the current buffer beinK 
prepared for transmission. * 

For further details on end of record action see section 6. 7. 6. 5. 

6. 7. 6. 3. 2 Sending the last Card 

To maintain compatibility with existing transmission programs it 
is essential they should operate without modification. This 
leaves a problem of how to send the final message buffer if it 
has not been filled up. If greater than 5 seconds elapses 
between characters sent from the Basic applications program, 
then the end of a complete transmission sequence is assured and 
the current block terminated by ETX CRC. After this has been 
acknowledged the EOT (end of transmission) is sent to close down 
the line. 


6 . 7 . 6 . 3.3 Receiving Cards 


The computer generating data for transmission to HUNTER will 
also block data into records. 

To provide application programs with »»CR" delimiters, any end of 
record is converted to CR. The end of record will depend upon 
the configuration in use. The sequences lUS CRC and IRS will 
always return CR. 

This means that HUNTERS will communicate directly when connected 
back to back. 

BSC receiving stations use ESC sequences for special functions 
like skipping line. These sequences are ESC n where n can be a 
number of printable characters. To avoid confusion when these 
are received HUNTER will ignore received ESCs and their 
associated following character. 
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6. 7. 6. 4 Character Restrictions 

HUNTER does not implement any of the transparency features of 
BSC. It is, therefore, not possible to send any of the 
following characters: 

STX - 02H 
ETX - 03H 
ETB - 17H 
EDT - 04H 
SYN - 16H 
NAK - 15H 
DLE - 10H 
US - 1FH 
ESC - 1BH 

If any of these characters are sent then they may either be lost 
or cause disruption to the transmission channel. 


6.7. 6.5 Configuring the Protocol 

For maximum flexibility there are a number of features which may 
be controlled by the user. These are controlled by a number of 
flags which are memory locations, listed through this section 
and also in section 9.7 Memory Locations. All of these 
locations are preserved after timing set, as with all other 
communications parameters such as transmission speed. 

They may be changed from within a user program using POKE in 
Basic or Direct writing in machine code. Alternatively, the 
Basic program "SENTSYNC’' will give a menu of options. A listing 
is included in section 9.5. 

6. 7. 6. 5.1 Record Length - (Memory location F853H or 63571) 

This is a single byte which defines the maximum record length. 
It has a range of 1-255, with a default of 80. When outputing 
data, this length should not be exceeded as there may be 
insufficient space left in the block to accommodate the record. 

If record padding is used, all records are either padded or 
truncated to fit this length. 
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6. 7. 6. 5. 2 Buffer Length - (Memory locations F854-F855, 63572-63573) 

This is a two byte number which defines the maximum length of a 
block. It has a permitted range of 10-512 with a default of 
200. The block length must be greater than the selected record 
length. This control is useful for adjusting the throughput for 
good or bad telephone lines when transmitting over modems or 
acoustic couplers. For a good line, the buffer length could be 
set to maximum so that line turnarounds are kept to a minimum 
and the maximum data is sent in one block. If, however, the 
line is a bad one, then if the buffer length is set to a single 
record length, the amount of data to be re-transmitted in the 
event of a NAK or data corruption due to the bad line, is kept 
to a minimum. On Receive, the block length can be anything up 
to 512 characters. 

It should be remembered that the block Includes all control 
characters and record separators. 

6. 7.6. 5. 3 Single Record Flag - (Memory location F856H or 63574) 

This flag controls whether there is single or multiple records 
in a block. If set to zero (default value) there will be 
multiple records in each block. If set non-zero, there is only 
one record transmitted per block. 

6. 7. 6. 5. 4 Record Padding flag - (Memory location F857 or 63575) 

This single byte flag is used to control record padding. If 
this byte is set to non-zero, a record is padded with spaces to 
its maximum length as defined by record length before being 
transmitted. On receiving a record, trailing spaces are 
stripped off. If this flag is set to zero, record padding is 
inhibited and trailing spaces are not stripped on reception. 
The default state of this flag is zero. 

Record padding is only normally used on fixed length 2780 
communications. 

6. 7. 6. 5. 5 Mode flag - (Memory location F858 or 63576) 

This flag determines the essential difference between 2780 and 
3780. It selects between terminating a record with US (IFH), 
followed by CRC, or with IRS (lEH) followed by CRC. 

2780 mode is the default with the mode flag set to 0. A non- 
zero flag selects 3780. 
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2780 mode: 

Fixed length records are terminated by any of the following: 

US,CRC : used for a partly filled buffer 

ETBjCRC : used for a full buffer 

ETX.CRC : used for the last buffer to be sent 

Variable length records are terminated by any of the following: 

EM,US,CRC : used for a partly filled buffer 

EM,ETB,CRC : used for a full buffer 

EM,ETX,CRC : used for the last buffer to be sent 

3780 mode: 

All records are terminated with: 

IRS 

On receive, record terminators (CR) are always returned for: 

US CRC 
IRS 


6.7.6.5.6 


6.7.6.5.7 


irrespective of the setting of the mode flag. 
SIX flag - (Memory location F859 or 63577) 


This flag is a single byte and controls the use of intermediate 
STXs. If the flag is set to non-zero, at the start of every 
intermediate record an STX is inserted. If the flag is zero, 
then STXs are not inserted except at the start of the first 
rroord in a block. Intermediate STXs are ignored on reception. 
The default of this flag is zero. 


This feature is normally only used in 278O installations. 
Retry flag - (Memory location F85A or 63578) 


^is single byte flag controls how the protocol handles errors. 
If the flag is set to zero (its default state), then when an 
error in communication causes the HU^^^ER to re-try sendine the 
last block, the HUNTER will re-try 10 times before givinra 
however, the flag is set to non-zero 
the HUNTER will re-try indefinately until either it succeeds or 
the operator switches the HUNTER off. 
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6. 7. 6. 5. 8 Space Compression flag - (Memory location F85B or 63579) 

This single byte flag controls the operation of space 
compression. If the byte is set non-zero, any string of more 
than 2 spaces is compressed into an IGS character and a space 
count code on transmission. The reverse happens on receive 
(i.e. the codes are expanded to the string of spaces). If the 
byte is set to zero (its default state) spaces are not 
compressed on transmission or expanded on receive. 

This feature is not normally used in 2780 installations. It can 
be used to give increased throughput on a line where there are 
many spaces. 

6. 7. 6. 5. 9 Addresses of RAM Locations 


Name 

Location 

(Hex) 

Location 

(Decimal) 

RECLEN 

F853 

63571 

BUFLEN 

F854 

63572 

SRFLG 

F856 

63574 

RPFLG 

F857 

63575 

EMFLG 

F858 

63576 

STXFLG 

F859 

63577 

RETRYS 

F85A 

63578 

SCFLG 

F85B 

63579 


Default Description 
Value 

80 Record length 

200 Buffer length 

0 Single record flag 

0 Record padding 

0 Mode flag 
0 STX flag 
0 Retry flag 

0 ^ace compression flag 


NOTE: These flags are preserved during power off and so will 
remain at their previous setting after subsequent power on. 
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FIG. 6. in SYNCHRONOUS BUFFER ORGANISATION 


Buffer Length 


Record Record Record 

Length Length Length 


IP! IS| DATA I I I DATA | | | DATA | | |E|C| | | | 

lAISYNSITI CHARACTERS | | | CHARACTERS | | | CHARACTERS | j |T| R ! | | 

ID! iXI ill ill II |B| |C| I I 


IRS 
or EM 
if 

selected 


Record Terminator. 

Depending on the state of the 
mode flat, this would be either: 

a) an IRS character, or 

b) an lUS character followed 
by 2 intermediate characters. 


An intermediate STX, 
if selected, would be 
inserted here. 

(Note: If selected 

the STX would not be 
counted as part of 
the Record). 


Line 

turnaround 

characters 

(FTTO. 


When calculating the buffer length, space should be included for the 
characters at the stert of the buffer (l.e. PAD.SYNS and STX), the characters 
at the end (l.e. ETB or ETX, 2 CRC characters and 2 line turnaround 
characters) and all the required record terminators and intermediate STXs. 
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6.7.7 

USE IN TERMINAL EMUUTTON MODE 

Although 2780 work stations are not generally interactive 
devices, it is possible to use HUNTER in this mode when, for 
example, testing the system with LOG ON cards, etc. 

When in Terminal Emulation any received data is displayed on the 
screen. 

To transmit, a message character may be typed in directly. 
Provided no mistakes are made, and there is less than 5 seconds 
between each character, the message is sent on the transmission 
channel. 

6.7.8 

COMMUNICATION ERROR 

There are a number of different line errors which may occur when 
using this protocol. These are detected and then displayed as 
communications errors. An error number is also displayed. The 
meaning of these error numbers is shown in section 6.7.5, 
MESSAGE TRANSMISSION. If use of the ON COMMS statement is made 
then the error number will be in the COMERR flag. 

There is one exception to this rule, see Fig 6.2, UNANSWERED 
LINE BID. This is the most usual error and will generally be 
due to a ccMinection fault, as no characters have been received. 
The option is then given to: Retry transmission ?(Y/N) if Hf' is 
pressed then HUNTER will send out up to 10 more ENQs (enquiries) 
and the offer of retry made again. If 'N' is pressed then the 
error OT is returned, and if programmed through ON COMMS, 
returns control back to Basic. 

6.7.9 

ERROR MESSAGES: 

6.7.9. 1 

Error 01: Unanswered line bid 

This is due to not receiving any reply in a request for the 
line, usually caused by incorrect connection of the 
communications channel. 

6.7.9.2 

Error 02: No response from receiver 

After establishing the line, a buffer has been sent to which no 
response has been given, despite 10 ENQs having been sent. 
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6.T.9.3 


6. 7.9.4 


6.7.9.5 


6 . 7.10 


6.7.11 


Error 03; Response not matched by odd-even block count 

The wrong positive acknowledgement has been given to a buffer, 
despite confirmation requests. 

Error 04: Retransmission rejected 

Repeated transmission of a buffer gets only the NAK response, 
has tried 10 times. 

Error 05: No ENQ after HACK 

Having sent out a WACK no acknowledging ENQ has been received 
for 5 seconds. 

HARDWARE HANDSHAKING 

This protocol is generally used with modems or modem simulators. 
The use of RTS (Request to Send) and CTS (Clear to Send) is 
therefore specified by the modem, particularly if half duplex or 
two wire operation is desired (as on the public switched 
telephone network). Both RTS and CTS may be deactivated as 
usual. 


If they are used, then the following takes place: 


1 ) 

2) 


3) 


If HUNTER is not transmitting then RTS is inactive, 
allowing the remote modem to transmit. 


when starting a transmission buffer the RTS is activated 
®^3rts CTS is awaited from the modem. 
When CTS becomes active HUNTER starts transmission. 

During transmission RTS is kept active, but CTS is not 
checked, if it became inactive the transmission would be 
broken and synchronism dropped. 


awaits deactivated and HUNTER 


There are no timeouts on the handshakes. 
HARDWARE CONFIGURATION 


The transmission channel could be the switched 
wire private lines etc. , 


public network. 
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|hunter| 


6 . 7.12 


Fig 6.13 HUNTER TO MAINFRAME CONFIGURATION 


TXCLK 

RXCLK 

TX DATA 

RX DATA 

RTS 

CTS 

DCD 

DTR 

DSR 


[modem a[^transmission} »- |modem ^ 


CHANNEL 
2/4 WIRE 


TXCLK 

RXCLK 

TX DATA 

RX DATA 

RTS 

CTS 

DCD 

DTR 

DSR 


I CPU I 


The two modems and the channel could be a modem eliminator for 
nearby operation. 

As can be seen the modems generally create all the clocking in 
this simple arrangement. HUNTER will not generate any actual 
clocking of its own, except when self synchronising to the data. 

The handshake signals RTS and CTS ensure correct data flow over 
a half duplex line (allowing the modems to settle etc.) They 
may not be necessary over 4 wire links. 


HUNTER TO HUNTER CONNECTION 

To operate this protocol back-to-back between two HUNTER'S it is 
only necessary to use a crossed 3 wire lead (TX,RX and ground). 
If the handshake lines are connected, then CTS must be 
deselected on the menu as the handshaking is only configured for 
modem operation. 

HUNTER'S need to be set for self clocking at the designed speed, 
typically 1200 baud or 300 baud over slow speed async modems. 
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6.8.1 


6.8.2 


6.8.3 


6.8.i1 


6.8.5 


TERMINAL EMULATION 


APPLICATION 

In terminal emulation mode, HUNTER can be used as: 

a) A remote terminal for dialup timeshare computer 
services. 

b) As a peripheral to other computers. 

c) As a portable 'Telex', able to communicate with other 
HUNTER'S or data terminals. 

CONFIGURATION 


HUNTER'S RS-232 serial interface is configured to represent a 
Data Terminal Equipment (DTE) for compatibility with Modems and 
other items. 

OPERATION 

First, check that the communication port is correctly 
initialised, see section 6.4, COMMUNICAHONS PORT SOFTWARE. 

SELECTION 


From 'File Manager' select 'TERMINAL EMUUTION' mode. You are 
now in HUNTER'S remote computer terminal emulation mode. 

HUNTER is now ready to communicate. 

The function keys are programmed as follows: 

Fn 4 CCMS 

Fn 8 SYST 


.If , ^"*"7 characters to be transmitted, including 

control characters see section 9.2, ASCII CHARACTER SET. * 

orfoTf^f® n®'”' the screen if 

printable. Upper and lower case alphabets are available. 

^nrtionTey?'""*"®^ Emulation mode is made via the 'SYST' 

PROTOCOLS 


Any protocols selected will be observed by HUNTER-, 
communication software package automatically. Remember that 

(CrT isTess:].' untn% “e®r^ 
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6.8.6 Buffers 

It should be remembered that the HUNTER is fully buffered with 
transmit and receive communications buffers, a keyboard buffer and a 
virtual screen effectively keeping early information available for 
use. 

At high receive data rates, e.g. 4800 baud, the receive buffer will 
remain full. If a "stop" is sent to the sending computer (e.g. XOFF 
or control S, sent manually) then the screen display will not stop 
immediately, continuing to display the characters stored in the 
receive buffer until the buffer empties. If this is found 
undesirable, the most straightforward solution is to reduce the data 
rate to 1200 baud. 

If 2780 synchronous transmission is used in terminal mode, a block 
will be sent if the keyboard has not been operated for 5 seconds. 
This does mean that when using terminal emulation in 2?80 mode for 
"signing-on", there should be no hesitation or typing errors or the 
block will be sent unexpectedly! 

6.8.7 Auto Power Off 

Terminal Emulation does not power off automatically. This is for 
ease-of-use when operating intermittently with a remote site. If 
auto power off were allowed, modems may drop the line resulting in 
messages lost, etc. 

It is important, therefore, to remember to switch off HUNTER after 
using Terminal Emulation. 

6.8.8 System Call 

User programs can use Terminal Emulation which is provided as system 
call number 43 (see section 3.5.3.44). Selecting "System" (function 
8) in Terminal Emulation will return control to the calling program. 

To use Terminal Emulation from Basic, the following is required; 

1000 A=ARG(43);A=CALL(5) 

Execution will continue after line 1000. 
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From a machine code or compiled program, a system call 43 is 
required, e.g: 


LD C,43 ; select call 

CALL 5 
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6* 9 COMMUNICATIONS ERRORS 


HUNTER provides a range of communications error messages to warn 
the user of failure situations. The error messages are designed 
Py the Basic ONCOMMS statement (see section 
5.16.3) and handled by the user's program. 

However, the errors can occur when HUNTER is under manual 
control (for instance, in TERM mode) or if the user's 
application does not contain ONCOMMS. In this event, HUNTER 
will display: 

• • * Communication Failure • » » 

— Error nn — 

where nn is the Error number. The attempt at communication can 
be aborted either by powering the HUNTER off or by pressing 
ENTER, in which case control is passed back to the DEMOS file 
manager. 

The available error messages are: 

6.9.1 Error 01: Unanswered line bid 

This is due to not receiving any reply in a request for the 
line, usually caused by incorrect connection of the 
comnunications channel. (Synchronous mode only). 

6.9.2 Error 02: No response from receiver 

After establishing the line, a buffer has been sent to which no 
response has been given, despite 10 ENOs having been sent. 
(Synchronous mode only). 

6.9.3 Error 03: Response not matched by odd-«ven block count 

The wrong positive acknowledgement has been given to a buffer, 
despite confirmation requests. (Synchronous mode only). 
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6.9.4 


6.9.5 


6.9.6 

6.9.7 

6.9.8 


6.9.9 


6.9.10 

6.9.11 

6.9.12 


Error 04: Retransmission rejected 

Repeated transmission of a buffer gets only the NAK response, 
has tried 10 times. (Synchronous mode only). 

Error 05: Loss of response from receiver. 

No ENQ has been received in reply to a WACK (synchronous mode 
only;. 

Error 06: Not used. 

Error 07: Not used. 

Error 08: Receive timeout Error 

Error 09: Transmit timeout Error 

^^smission has not been able to take place for the specified 


a«uri:7rp"a^eV38)!''^“^'’'® ^^ee 

Error 10: ETX/ACK timeout Error 

No response has been received for 30 seconds. 

Error 11: ACK/NAK failure 

Three attempts have failed to get an ACK. 

Error 12: Systime failure 

Ten re-transmlsslons have failed to get an ACK. 
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SECTION 7.1 


INTRODUCTION 


Hunter's built-in text editor provides practical text handling 

I if ® 


It may be used for the creation and alteration of standard ASCII text 
files for reports, correspondence, etc. This feature is invaluable 
for text entry 'on the move' in trains, planes or any other form of 
transport. Text may then be easily printed out on return to the 


Husky Basic files, which are encoded to save memory and execution 
time, may also be edited directly. These files are recognised by 
their use of the .HBA suffix. It is important, therefore, to 
maintain the .HBA suffix convention when attempting to edit Basic 
programs. 


7.1.1 


NOTE: Encoded source files for other 

MBASIC cannot be edited with this editor. 


interpreted programs e.g. 


Automatic Cont Edit 


On entry to the Editor from either Basic or Demos, the HUNTER is 
forced into Cont mode. This applies even if the Editor has been 
initiated but the HUNTER is still converting a Basic tokenised 
program into its text equivalent and the normal Editor screen is not 
yet displayed. 


If the HUNTER is now powered down, either by manually pressing the 
power key or by auto-timeout due to lack of keyboard operation, then 
on power up the HUNTER re-enters the Editor and continues operation 
from where it* ceased at power down. This applies in all cases e.g. 
midway through a search, writing to a file or exiting to Basic and 
recreating a Basic tokenised file from its text equivalent. This 
feature ensures that all data entered into the Hunter whilst in the 
Editor is always accessible to the user. On exit from the Editor, 
either by 'Exit' or 'Save', the HUNTER is forced out of Cont mode 
automatically. Thus, if the HUNTER is powered down, then it will 
power up normally. 


7.1.2 Editor program size check 


When the Editor is initiated, an automatic check on the file size is 
carried out. Since the Editor uses only the TPA for its work space, 
if a text file greater in length than the TPA is attempted to be 
edited, a warning message will be displayed and the operation will be 
aborted. 


NOTE: The file will not have been changed in any way and the Hunter 
will not be in auto Cont mode. 
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In the case of editing a Basic token ised program, a check is carried 
out on the size of the tokenised program so that its text equivalent 
form would not be greater in length than the size of the TPA. 

Basic programs are tokenised so as to reduce the amount of memory 
required to store the program and increase the speed of operation of 
the Basic program. On converting a Basic tokenised program into its 
text equivalent, the size of the program increases by approximately 
1/3. Hence, although the size of the Basic tokenised program 
(obtained by using the STAT command in DEMOS) indicates that it would 
fit into the TPA, this, of course, does not imply that its text 
equivalent would fit into the TPA and, therefore, it cannot be 
assumed the Basic tokenised program can be edited. 

The maximum size of a Basic t<^enised program which can be edited is 
approximately 36K bytes. Hence, for normal applications this size 
check does not Inpose limitations upon the HUNTER. 
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INITIATING THE EDITOR 


The editor can be invoked from the operating system, DEMOS, or 
directly from BASIC. In either case, procedures are similar but, on 
exit, the user will be returned either to the operating system or 
Basic as appropriate. 

7.2.1 Entry from the operating system, DQ10S 

From DEMOS, either type EDIT, followed by the desired filename, or 
use function key 7 followed by the filename. 

The entry line will look like: 

>EDIT myfile.txt 

This line will edit the file myfile.txt. Pressing Enter will invoke 
the Editor and if the file already exists, will load it into the work 
area. If the file does not exist, it will be created on exit from 
the editor provided text entry has been made. 

It is essential to enter a filename. If the suffix is omitted, the 
file will be assumed to be ASCII and have the standard default 
extention TXT. If it is desired to edit a Basic file, the .HBA 
suffix must be entered. 

Assuming myfile.txt does not exist, the screen will show: 


|CX:00 INS:on Caps:off 


Caps Find Cins Save Ldel Exit 


On the top line there are three items of information: 
a) COLrOO 


This shows the column which the cursor is in. It is in thp 
range 0 to 79. As the cursor moves, It is kept updated and may 
be used for aligning tables, indents in text, etc. ^ 


Column 0 is the left of the virtual screen, 
extreme right of the virtual screen. 


Column 79 is the 
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b) INS:on 


ILi A . entered will be placed at the cursor 
position and any text already present will be moved. With 
insert off, the display will sliow: movea. witn 

INS; off 


In this case, entries will overwrite existing text, 
c) Caps:off 


piis stows the state of the CAPS lock function which 
described in section ^.5. 


operates as 


NOTE; The CAPS LOCK inverts upper and lower 
characters, but is not a 'Shift Lock' functio 
characters are available by pressing 'Shift'. 


case 

n. 


alphabetic 
Lower case 


provide up, down, forward and backspace functions. Lines are 
terminated by 'Enter' which is equivalent to CR (Carriage Return). 

If the file already exlsta, the first few lines of text will appear 
on the screen. 


|COL:00 INS:off Caps:off } 
I This is a demonstration of entering tex I 
|the text editor. On this screen it can b| 
|we only display the top left of the file I 
i I 
I Paragraphs are generally indented, thisi 
Ino problem to the Hunter text Editor. | 
leaps Find Cins Save Ldel Exit I 


This is the beginning of the file and the left-hand 
Text editing may now proceed as required. 


forty columns. 


NOTE: Exit from the editor after entering from DFMOS will 
changes to the file, unless the file is previously saved. 


abort any 
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7.2.2 Entry from BASIC 

When In Basic (see section 4), it is possible to use the Editor to 
load a file or to Edit a program which has already been loaded into 
the TPA. 

To Edit a Basic program already resident in the TPA, it is only 
necessary to type: 

EDIT (followed by 'Enter') 
or 


Fn key 3 (followed by 'Enter') 

There will be a slight delay while the Basic program is un-entokened 
to give an ASCII representation. The screen will then appear as 
shown above and editing can proceed as required. 

Alternatively, if a new file is to be loaded into the workspace, 
entering: 

Edit "filename" (followed by 'Enter') 

If the file extension is omitted, the .HBA extension will be assumed 
and will first load the file and then invoke the editor. 

When exiting from the Editor after entering from Basic, use of EXIT 
will cause the ASCII character representation used by the Editor to 
be en tokened ready for execution by Basic. This procedure can take a 
few seconds for larger programs. 

After EXIT, the user is returned to Basic. 

NOTE: Any unnumbered lines will not be entokened and consequently 
will be lost. Any duplicated line number will cause the earlier 
entry to be lost. 


V 
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7.3.1 


EDITOR OPERATION 


function and operates as a file-based system. 


When a file is loaded into the Editor, it is placed in the TPA (see 
section 3.3), the 54K workspace used by HUNTER. This is the only 
Editor operates on a file. The whole file must be 


The maxinum text file size wich can be edited is 54K bytes. 

7.3.2 Basic Files 


file is loaded, then it is first un-entokened to 
AcoTT ^^eracters. This is because the Editor will only operate in 
ASCII within its work area. A short delay of a few seconds on entry 
and exit to the Editor will occur when operating on Basic files. 
This delay obviously gets longer with larger programs. 

7.3.3 The Keyboard 

The diagram of the keyboard shown in Fig 7.1, shows the function 
associated with each key when used as a control key (i.e. hold down 
CTL/FN and press the appropriate key). 

All the function keys are replicated ^ control keys which conform 
broadly to the layout used by Wordstar^”. 

NOTE: The Editor uses the virtual screen, so the cursor keys (fully 
described in section 2.6) may be used to scan around the text in the 
virtual screen. 

The label line cannot be turned off with LBL when in the Editor. 

The operating system scans the keyboard every I8ms and stores the key 
code in a 32-key keyboard buffer. This buffer is examined by the 
user's program and operating system whenever necessary. When in the 
Editor mode, the operating system is examining this buffer and taking 
appropriate action when necessary. There are occasions when the 
screen handler cannot keep pace with keyboard entries due to 
considerable and repetitive editor workspace access. This may become 
a problem when an excessive number of character delete key operations 
are performed. It is, therefore, advisable not to invoke the auto- 
repeat function when only a limited number of deletes are required 
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FIG. 7.1 
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7.3.^ Line Length 

UnT “'“■■“t.rs by wrapping 
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EDITOR COMMANDS 


7.^.1 Commands made through the function and control keys may generally be 
made at any time. 

Each group of commands will be described individually. Reference 
should be made to Fig 7.1 which stows the complete keyboard functions 
available. 

NOTE: Control and function keys are denoted with a leading up 
'carot' (*), e.g. Control G is shown as 'tl and function 2 as '‘2, 
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1.^,2 


ARROWS 


Up arrow 
Down arrow 
Left arrow 
Right arrow 


♦rxrj - 


FUNCTION: These keys move the cursor non-destructively in the 
required direction. They may be used to place the cursor 
over any character position which is in use. 

These keys will not place the cursor outside the text area, 
i.e. before the beginning of the file, after the end of the 
rile, or past the end of the line currently written to. 


previous/following line if the end of a line is reached. 

When 'shifted', these keys access the virtual screen. 

When pressed with "CTL/FN", they have the following functions: 

1 ) Up and down cursor keys adjust display contrast. 

2) Left and Right cursor keys display left and right halves of the 
virtual screen. 
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CAPS LOCK 8c TAB 


7.4.3 KEYS: XBL 

'‘1 
TAB 
'‘I 


Caps Lock 
Caps Lock 
Tab 
Tab 


FUNCTION: CAPS lock forces all alphabetic characters to capitals. 

This function is shown on the top line of the display. 
Pressing caps lock a second time turns the function off. 

TAB moves the cursor onto the next tab position in units of 
8, i.e. column 8, 16, 24, etc. 


RDiAHKS: CAPS lock is useful for entering programs. 
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CHARACTER INSERT 


• *3 - Character Insert 

V - Character Insert 


condition of the function is 
INS: on 

When turned off, characters entered overtype existing text. 

When turned on, new text is inserted before the cursor 
Slddle oT a u™.'" Characters to the 


^ Carriage return is added as with any 

?n thP ® the cursor is 

in the middle of the text. With insert off, the carriage 

fhi ^ ^ ^ cursor is moved non-destructively to 
the beginning of the next line. ^ 
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DELETE 


7.^*.5 KEYS: DEL - Delete 

BS - Back space 

'T3 - Delete ahead 


FUNCTION Delete destructively moves the cursor back over the 
previous character. The character to the left of the 
cursor is removed and the rest of the line is moved one 
character to the left. 

Backspace operates exactly as back arrow. It moves the 
cursor non-destructively one character to the left. 

Delete ahead destroys the character on which the cursor is 
positioned. The cursor remains stationary and text ahead 
of the cursor is moved towards it. 


REMARKS: Carriage return may be deleted. This has the effect of 

concatenating lines. 

WARNING: Because HUNTER has a 32 character keyboard input 
buffer, Deletes' can be stored up in auto-r^eat mode more 
quickly than they appear on the screen. This will have the 
effect of 'eating' the text! 

Do not hold the Delete key down. Instead, use single key 
depressions or Line Delete (see section 7.^.9). 
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EXIT 


7.^1. 6 KEYS: *8 - Exit 

"U - Exit 


RINCTION: Exit operates slightly differently, depending on whether 
the editor was entered from either DEMOS or Baslo. In 
either case, pressing Exit clears the label line and 
presents the question: 

Exit Y/N? 

answering N aborts the command and returns the cursor to 
Its previous position. 

Answering Y when entered from DEMaS exits from the editor 
with no change to any file. Any alterations are lost. 

Answering Y when entered from BASIC re-processes Uie file 
into BASIC encoded form and leaves the edited Baslo source 
In the workspace for execution. 

When Exit Is in progress: 

»• Walt 

is displayed on the bottom line. 
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FILE START AND END 


7.4.7 KEYS: 'V - File start 

''7. - File end 


FUNCTION: These commands place the cursor non-destructively at the 
beginning or end of the file. 

File start : positions the cursor on the very first 

character, as if the Editor had just been 
entered . 

File end : places the cursor at the end of the file. 

The screen displays the last line of the file 
and puts the cursor on the second text line 
of the screen. 

REMARKS: Very useful for adding text to a file. 
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7.4.8 KEYS: 

*'2 - Find 

'‘O - Find 

FUNCTION: 

Find is used to seach the file for a specified string. The 
search is only forward from the cursor position to the end 
of the file. There is no search prior to the cursor. 

After activating Find, the label line is cleared and the 
message: 

Find? 

is displayed. The desired string is typed in (up to 68 
characters). After pressing Enter, the search is started 
and the message: 

Wait 

is displayed. Tf an exact match for the desired string is 
found then the cursor is placed on the first character. 

If no mat^sh is found, the message: 

** Failed 

is displayed on the bottom line and the cursor returned to 
its original position. 

If it is desired to find the same string a second time, 
then pressing only Enter after the "Find?" prompt will 
cause the search to go on through the file looking for the 
next occurrence. This should not be done for the first 
search after entering the Editor as the command will be 
rejected. 

REMARKS: 

Find can be aborted by entering ESC. 

The "failed" message disappears after any key depression. 
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LINE DELETE 


7.4.9 KEYS: ^ - Line Delete 

- Line Delete 


FUNCTION: Line delete rerroves the line on which the cursor is placed. 

The cursor must be placed at the beginning of the line to 
be deleted. 
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LINE START AND END 


7.4.10 KEYS: -Q - Line Start 

'T - Line End 


FUNCTION: These keys move the cursor non-destructively to either the 
beginning or end of the line. 


REMARKS: Useful for adding text to the end of a line. 
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7.4.11 KEYS: 

'‘R - Page Up 

“C - Page Down 

FUNCnON 

These keys are used to scroll the text page by page. 

Page down will firstly place the cursor at the bottom of 
the screen being displayed. Further operations will 
display pages six lines at a time to the end of the file. 

Similarly, page up will initially place the cursor on the 
top line of the display and then backwards page by page to 
the beginning of the file. 

REMARKS: 

Useful for reviewing text. 
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7.4.12 KEYS: 

'‘B 


save 

save 


FUNCTION: This command is for saving modified text into a file. 

After entering the command, the label line is cleared and 
the message: 

Save Filename ... 

is displayed. If ’Enter* is pressed Immediately, the text 
is stored back into the file originally loaded. Otherwise, 
a new file is created with the text. However, if the 
Wlt^r was entered from Basic by simply pressing Edit and 
then Enter, then a new file called ’HUNTER.HBA* will be 
created unless a filename is specified. 


If .HBA suffix is used, then the file will be assumed to be 
a Basic source file. Any other suffix will always create a 

f av4> 1 a j ^ 


REMARKS: If there is insufficient room, then DEMOS is re-entered and 

the error message: ^ 

Disk Full File length = n blocks 

is displayed where n is the number of blocks needed to save 
all the file currently in the Editor. By clearing 
sufficient space in the HUNTER it is possible to sa^e the 
file in the Editor using the file manager command: 

SAVE n filename 

where n is the same number displayed in the error message. 


This will happen even if the Editor was entered from Basic. 
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WORD SKIP 


7.4.13 KEYS: '‘A - Left word 

''F - Right word 


FUNCTION: These keys move the cursor non-destructively left and right 
pausing only on spaces. Otherwise, they operate exactly as 
left and right arrow keys. 


REMARKS: A fast method for gaining position in text. 
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SECTION 8.2 


8.2.1 


8.2.2 


8.2.3 


CASE SEALING 


stajdard hunter 

All HUNTER'S are built with integral seals to provide a high 
degree of protection against atmospheric moisture, corrosive 
gases and accidental immersion, therefore HUNTER should not be 


■nc battery seal 


running in a machined groove in 
the battery plug and seating on a machined face in HUNTER 

CSS • 

leaUng?^ requires a smear of silicon grease to assist in 
SEAL SPECIFICAnON 


p3^t no. 

1.5mm X 30mm HUN-05710 


Replacement seals may be obtained 
authorised agents. 


from HUSKY Computers or 
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PRESSURE RELIEF 


8.3 Under certain circumstances (change of altitude, etc.) the 

interior of HUNTER may have a substantial pressure difference 
compared with the environment. This can lead to two 
consequences in HUNTER. 

1) Internal overpressure : making the keys stiff and 
difficult to operate. 

2) External overpressure : a tendency to ingest any 
rainwater adjacent to the seals, and in extreme cases, the 
possibility of activating the keys. 

In either case, any pressure differential can be released by 
slightly loosening the battery cap. 

If you are taking HUNTER on an airline trip, this is a sensible 
precaution to take. 
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HUMIDITY INDICATOR 


HUNTER'S interior is kept dry by an internal store of silica gel 
desiccant, kept in a muslin bag. The dryness of HUNTER'S 
interior is essential to its correct operation, and is indicated 
by a humidity indicator in the comer of the display window. 

The colour of the indicator should be checked at intervals. 

TW: HUHIDITY INDICATOR MUST ALWAYS BE BLUE 

If it takes on a pinkish colour, the unit must be returned to 
HUSKY Computers promptly to avoid corrosion of internal parts. 
If the colour changes immediately after an accident involving 
water or high humidity, a fault has occurred in the sealing, and 
there could be water inside the unit. 

If you suspect that water has entered the interior, you MUST 
take the following action: 


1) Remove the battery 

2) Return HUNTER to HUSKY Computers, or authorised agents. 
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8.5.1 



8.5.2 


j 


BAR CODES AND LIGHT PENS 


As an option HUNTER is capable of reading 2 types of barcodes: 

a) Code 39 

b) EAN 8/13 

To provide these facilities software packages are loaded into 
the file system of HUNTER as permanent files. Access to these 
files is not allowed to the user. However, the operating system 
accesses the files in order to support the wand option when 
required in programs utilising the Basic statements such as 
WINPUT, WINCHR etc. Access to the files is totally transparent 
to the user. 

Other codes are available to special order. 

If an attempt is made to access these files without them being 
present, then a "system file error" will be displayed. 

See section 9.9.3, LEMO CONNECTOR, for details of connecting and 
removing the LEMO plug. 

BAR CODE SCANNING TECHNIQUES 

There are a few simple rules to follow when using a hand held 
wand: 

Check that the tip of the wand is free from dirt. Prolonged use 
of the wand may lead to a build up of dust inside the tip, 
covering the lens. To check for this the tip must be unscrewed 
and, if dust is found, a gentle wipe with a soft cloth will 
remove it. The performance of the wand will not be immediately 
affected by a build up of dust, but rather a gradual decrease in 
the reliability of the wand operation. A weekly check should be 
all that is required for normal use. 

The tips of certain wands are made of plastic and as such, 
pressing the wand firmly onto the bar code will result in tip 
wear. This will affect the wand performance since the focal 
length of the lens will not coincide with the distance between 
the barcode and the lens, l.e. the bar code will appear to be 
'out of focus'. It is recommended that the wand be held gently 
in the hand and moved lightly across the bar code for best 
results. 

It is recommended that the scan should be carried out at a 
constant speed with the wand in contact with the barcode 
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throughout the scanning period. The scan should be at right 
angles to the bars of the bar code. However, HU^f^ER tolerates a 
considerable variation in the scan technique. 

The scan can be slow, fast, traversed across the bar code in an 
arc rather than a perfect straight line, or even scanned in a 
•wavy’ line, provided that the wand remains within the bar code 
region. HUNTER will allow both Code 39 and EAN 8/13 bar code 
types to be scanned either left to right or right to left. 


NOTE 'Code 39* is the trademark of Intermec Corp. 

It is not necessary to place the wand precisely at the beginning 
of the bar code before a scan since HUNTER will work out which 
information transmitted from the wand actually corresponds to 
the bar code itself. If the wand is resting on a bar code, it 
is possible to move the wand to either end of the bar code and 
then scan in the opposite direction. HUNTER will then work out 
the beginning and end of the bar code. 

HUNTER will allow a maximum of 16 characters to be represented 
by a Code 39 bar code. This should be borne in mind if the 
reader intends to produce his own Code 39 bar codes. If larger 
codes are required, contact HUSKY Computers for details. 


8.5.3 EUROPEAN ARTICLE NUMBER, EAN 8/13 

There are 2 EAN bar code formats: 

a) EAN 8 Short Version 

b) EAN 13 Full length Version 

Both a) and b) are used in marking retail articles of sale in 
shops, Hypermarkets, warehouses, etc. 

EAN 13 is the general name used to describe a series of barcode 
formats of which ANA (United Kingdom) is one particular version. 
See TABLE 8.1, ASSIGNMENT OF PREFIX DIGITS BY EAN, for precise 
details. 

The general form of EAN 13 is 13 all-numeric digits comprising: 
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First 2 digits 

Prefix denoting the National Numbering Authority administering 
the remainder of the number. 

Next 10 digits 

National Article Number, the structure of which is determined by 
the National Numbering Authority. 

Last digit 

Check digit, calculated by modulo-10 arithmetic, i.e: 


Prefix National Article No. Check 

PI P2 xxxxxxxxxxxxxxxxxxx C 

eg: 5000183962862 

In the above example the prefix is 50, i.e. the numbering 
authority is ANA, the United Kingdom's authority. The National 
Article Number is 0018396286 and the check digit is 2. 

The EAN 8 system is an entirely independent series of numbers of 
8 digit length. The general form of which is: 

First 2 digits 

Prefix, as in EAN 13 

Next 5 digits 

National Short Article Number 
Last digit 

Check digit, as in EAN 13 

Prefix National Article No. Check 

PI P2 xxxxxxxxxxxxxxxxxxx C 

e.g: 

50159109 

where, the prefix is 50 and so the National Numbering Authority 
is ANA. The Short Article Number is 15910, and the Check Digit 
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The general format of EAN 13 is shown in Fig 8,2, 12 CHARACTER 
BAR CODE. As can be seen, there are 3 types of guard patterns; 
2 normal guard patterns and a centre guard pattern. Only 12 of 
the 13 digits are represented by barcodes and the 13th digit 
must be calculated by considering the mixture of characters 
which represent the first 6 digits. The first 6 digits are 
represented by characters chosen from either Set A or Set B, 
whilst the last 6 digits are represented by characters from Set 
C only. See Fig 8.3, CODING OF NUMBER CHARACTERS. The allowed 
combinations of Set A and Set B characters are shown in TABLE 
8.4, COMBINATION OF SET A AND SET B CHARACTERS. 

The general format of EAN 8 is shown in Fig 2.3, 8 CHARACTER BAR 
CODES. Note in this case that the first 4 digits are all chosen 
from Set A and the last 4 digits from Set C. Again, the guard 
bars are present. 

Due to the fixed parity (all from Set C) of the last 6 digits in 
EAN-13 and the last 4 digits in EAN-8, both types of barcodes 
may be scanned in either direction, i.e. the barcodes are bi- 
directional. 
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TABLE 8. 1 ASSIGNMEIfT OF PREFIX DIGITS BY EAN 
Prefix Values 

00-09 (Reserved for UPC) 

20-29 In-Store Numbers 

30-37 Gencod (France) 

40-43 CGS (Germany) 

^9 Distribution Code Centre (Japan) 

50 ANA (United Kingdom) 

54 ICODIF (Belgium) 

57 Dansk Varekode Administration (Denmark) 

61-62 (Reserved for DCI) 

54 The Central Chamber of Commerce (Finland) 

65-69 (Reserved for DCI) 

70 (Norway) 

73 Swedish EAN Committee (Sweden) 

76 Schweizerische Artilelkode Vereinigung (Switzerland) 

77 APNA Australia 

80-83 (Italy) 

84 AECOC (Spain) 

87 UAC (Netherlands) 

90-91 BAN -Austria 

978 ISBN 

979 Reserved for ISBN 

98-99 Coupon Numbers 
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Fig 8.2 12 CHARACTER BAR CODE 


NORMAL 

GUARD 

PATTERN 


CENTRE 

GUARD 

PATTERN 

I 


NORMAL 

GUARD 

PATTERN 


6 LEFT HAND 
NUMBER 
CHARACTERS 
WITH VARIABLE 
PARITY 


6RIGHTHAND 
NUMBER 
CHARACTERS 
WITH FIXED 
PARITY 



13ih DIGIT 
ENCODED BY 
VARIABLE PARITY 



678900 



HUMAN-READABLE 
CHARACTERS IN OCR -B 
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Fig 8.3 CODING OF NUMBER CHARACTERS 
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H&mnMKE AMD MXES CTI ES 


SEmai.8.5 


TML£ 8.A COHBDWTIOC OF SET A. /W) SET B. CHARACTERS. 


Value of 
13th Digit 

Rupfcer Sets used for Coding left 
half of sywbol 

1 

2 

3 

4 

5 

6 

0 

A 

A 

A 

A 

A 

A 

1 

A 

A 

B 

A 

B 

B 

2 

A 

A 

B 

B 

A 

A 

3 

A 

A 

E 

B 

B 

A 

4 

A 

B 

A 

A 

B 

B 

5 

A 

B 

B 

A 

A 

B 

6 

A 

B 

B 

B 

A 

A 

7 

A 

B 

A 

B 

B 

A 

8 

A 

B 

A 

B 

B 

A 

9 

A 

B 

B 

A 

B 

A 
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Fi« 8.5 8 CHARACTER BAR CODE 
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8.5.4 CODE 39 

CODE 39 is an alphanumeric bar code consisting of 43 data 
characters (0-9i A-Z, 6 symbols and space) and a unique 
start/stop character These characters are represented by 

light and dark bands, as shown in Fig 8.5, CHARACTER BAR CODE. 

Code 39 is so named due to the structure of each character being 
represented by 9 elements (5 bars and 4 spaces) 3 of which are 
wide and the remaining 6 are narrow. A wide bar or space is 
assigned a value 1, and a narrow bar or space is assigned a 
value 0. Gaps between characters have no value. 

The number of characters in a code is limited only by the 
capabilities of the reader equipment or by human factors if a 
hand held wand is used. 

Each code starts and ends with an asterisk, thus the code 
may be scanned in either direction. 

The width of a unit bar may vary considerably allowing various 
printing methods to be used to produce the characters, e.g: 
offset, letter press, dot matrix printers. The recommended 
standard density is 9.4 characters per inch, but a density of 
1.4 characters per inch may be used for corrugated containers. 

A complete Code 39 bar code consists of a leading white space 
(referred to as a quiet zone), a start character, data 
characters, a stop character and a trailing quiet zone. 

A check digit may be produced if required and is modulus 43. 
The check digit is the last data character and calculated in the 
following manner: 

Suppose the data characters are: 

1234 5 ABODE/ 

then the sum of the data characters are: 

1+2+3+4+5^.lOf1 1+12+13+14+40=115 
Now, 115/43=2 Remainder 29 

The check digit is the character corresponding to the value of 
the remainder, which in this example is 29, i.e. ”T". 
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Therefore, the complete data character sequence is: 

12345ABCDE/T 

The numeric values assigned to each Code 39 character is shown 
in TABLE 8.6, CODE 39 CHARACTER VALUES. 
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Fig 8.6 CODE 39 CONFIGURATION 
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TABLE 8.7 CODE 39 CHARACTER VALUES 


CHAR. 

CODE 

CHAR. 

CODE 

CHAR. 

CODE 

0 

0 

F 

15 

U 

30 

1 

1 

G 

16 

V 

31 

2 

2 

H 

17 

W 

32 

3 

3 

1 

18 

X 

33 

4 

4 

J 

19 

Y 

3** 

5 

5 

K 

20 

Z 

35 

6 

6 

L 

21 

_ 

36 

7 

7 

M 

22 


37 

8 

8 

N 

23 

Space 38 

9 

9 

0 

24 

$ 

39 

A 

10 

P 

25 

/ 

40 

B 

11 

Q 

26 

•f 

41 

C 

12 

R 

27 

% 

42 

D 

13 

S 

28 


E 

14 

T 

29 
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BAHERY CHARGER 


THESE INSTRUCTIONS RELATE TO PERSONNEL SAFETY AS HELL AS 
RELIABLE OPERATION OF HUiTER AMD BATTERY CHARGER. IT IS 
IMPORTANT THAT TTCT ARE READ AND UNDERSTOOD. 

8.6.1 DESCRIPnON 

HUNTER'S rechargable battery system consists of four rechargable 
cells and a HUSKY HUNTER battery charger. 

The cells are 'AA' size Nickel Cadmium (NiCad) of nominally 1.2 
volts, 0.50 Ah and are capable of being charged at 65mA 
continually. 

The special HUSKY HUNTER battery charger is the only unit which 
may be used to recharge the NiCad batteries when they are 
installed in HUNTER. The use of an ordinary AC adaptor/battery 
eliminator may damage HUNTER or the batteries. 

8.6.2 WARNING 

When using the charger be absolutely certain that HUNTER has 
four NiCad cells correctly aligned and no alternative type is 
present. Do not even mix NiCads of differing age or state of 
charge. A risk of chemical leakage, gassing or explosion exists 
if anything other than a matched set of recommended NiCad cells 
are charged. Do not attempt charging at temperatures of 5°C or 
less. 

The charger contains lethal voltages, under no circumstances 
must it be opened, in any way tampered with, or used for any 
other purpose. It must, of course, be kept dry. There are no 
user serviceable items inside the case. 

If the charger is suspected of being faulty, then the fuse 
inside the mains plug may be changed for a similar fuse not 
exceeding 2 amps rating. The charger unit is fully protected 
against continuous short circuits but if unlikely fault 
conditions arise which cause overheating to the charger, it will 
self destruct, quietly and safely. The charger is double 
insulated, making no earth connection. 

8.6.3 OPERATION 

To use the charger unit the following procedure is reconinended: 

1) Switch off HUNTER. 

2) Plug the charger into HUNTER'S LEMO connector. 

3) Plug the charger into the mains. 

4) Finally switch mains on. 
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8.6.4 


8.6.5 


See section 9.9.3, LEMO CONNECTOR, 
removing the LEMO plig. 


for details of connecting and 


charger but the 


apparatus the charger should be dls- 
Only 240 vAC (220 to 


Exhaust^ batteries will typically be fully charced in IP 
overnight charging 1s a popular practlcT ® 


NICAD REPUCEMENT 


^ ^ ^ reduced by repeated or prolonaed total 

discharge and by excessively high temperatures. 


^/®'=‘^«';8e/charge cycles are required before NiCad 
f capacity. This type of battery will also 

rfif elevated temperatures, which can 

® charged set of batteries becoming flat in a 

pw weeks. An occasional charging session, say, every fortniaht 
is recommended if HUNTER is being stored. fortnight 


MAINS OPERATION 


operations, permanent charging may be 

charger^°a"d TO 

thll^ln^tante. would be a prudent action In 
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9 . 1 .^ 


9.1.5 


Screen handling 
(graphics mode) 


Keytx)ard 

CWffjNICATIONS 

Type 


:B 3 th text and graphics information are 
displayed together. There are five 
selectable character sizes giving 
facilities for elegant, professional 
screen formatting. 

:A11 keys re-allocatable in software. 


:RS-232/V?^» serial port on standard 25 
pin 'D' type connector. 


Configuration : Entirely software controlled. 

Baud rate :Up to ^00 baud asynchronous. 


Protocols 


Handshaking 


GRAPHICS 

Full addressing of 
all 240 X 64 dots 


rStandard ’invisible’ protocols for 
flow control and security are 
transparent to user programs. Formats 
provided include: (a) none/simple 
’TTY' communication, (b) XON/XOFF 
for mini and main frame computer 
systems, (c) ETX/ACK for many popular 
printers, (d) ACK/NACK for secure 
telephone communication, (e) Systime, 
with BCC error checking, (f) 2780 
fully synchronous implementation. 

:RTS, CTS, DTR, DSR, RT, CD, all 
selectable by software. 


rSoftware support for lines, boxes, 
circles and points. 


9.1.6 SOUIID 

Fully programmable for:4 octave range 
note and duration. 
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9.1.7 


9.1.8. 


9.1.9 


character SETS 


Five different sized 
charactersets selectable 
from Basic. Reverse 
video characters 
supported for all sets. 


:True descenders 


on larger sizes. 


MEMORY 


Type 

Retention 


Capacity 


Firmware 


:CM0S low power semiconductor RAM. 

lottery support with soldered in Ni/Cd 
backup. 


:Available in RAM size options of 80k 
byte, 144k byte and 208k byte. 
Operating system utilises 8k byte of 
this memory. 


:Built-in operating system including 
file manager , Basic interpreter and 
disk emulator. 


Upgrading 
REAL TIME CLOCK 


: RAM memory can be upgraded on return 
to factory to larger size 


Type 

rSoftware accessible time of day and 
calendar clock. Totally independant of 
mic roproc essor . 

Accuracy 

worst case, typically 2 sec per 

Integrity 

:Non volatile, battery backed. 

MICROPROCESSOR 


Type 

:NSC800-4 

Software 

instruction set 

rp?M standard 

CP/M compatible programs. 

Cycle time 

;2S0ns (4MHz) 


VER.V09F 


PAGE 9-3 


APPEIDIX 


SECTION 9.1 


9.1.11 BATTERIES 


Main 

:Four *AA’ cells, Ni/Cd rechargeable 
for daily use. Mallory MN1500 for long 
shelf life and reliability.Typical 
operating lifetime (software 
d^endant) 14h (Ni/Cd) 45h alkaline. 

Secondary 

:Built-in Ni/Cd charged from main cells 
when operating. Life 50h when main 
batteries are discharged. 


HUSKY Computers reserve the right to alter the specification or 
conditions of any product or service without prior notice. 
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ASCII CHARACTER SET 



Dec 

f\i m ^ iT> vo r- 

OO 0> p •— CM 

^ in vo 


Char 

a O' t. n 3 

V 

w 

X 

y 

z 

{ 

I 

} 

DEL 

6 

110 

Dec 

96 

97 

98 

99 

100 
101 

s s s s s 

107 

108 

109 

110 
111 


Char 

a 

b 

c 

d 

e 

bO £ — ) 

k 

1 

m 

n 

o 


Dec 

S OO M ® M OT 

86 

87 

88 

89 

90 

91 

92 

93 
9'< 
95 

in o 

1 Char 

O CC (O H 3 

> » X >. N 

- / - - i 

001 

’ Dec 

3 ig 5 S S 

p — CM pn ^ 
r* p»- t*- 

75 

76 

77 

78 

79 


Char 

8 

A 

B 

C 

D 

E 

U. o 3C 

X X z o 


Dec 

CO CT* C •— CM PO 

^ -sr in in in »T> 

3 in in in S 

59 

60 
61 
62 
63 

m ^ 






s 

u 

o — CM pn ifi 

VO oo o> .. 

< 

> 

? 


Dec 

32 

33 
3«< 

35 

36 

37 

R R § 3 S 

^ O ^ VO 


Char 

SP 

1 

$ 

% 




Dec 

^ ® ^ 

Rl fj ^ KJ « 

ni CM Ki ^ ^ 

too 

i 






5 

o 

Ul — (M PO jr 

d H Si 

SYN 

ETB 

CAN 

EM 

SUB 

a a a g 

0 

000 

' Dec 

o •- CM po JT in 

VO oo O' o 

•- <\j rr> ^ m 


5 

o 

i 1 B E § g 

§ ^ a b 

H u. a: o 

> U. U C/i CaJ 

%/ 


0000 

0001 

0010 

0011 

0100 

0101 

0110 

0111 

1000 

1001 

1010 

1011 

1100 

1101 

1110 

1111 

/ Q 


O •- CM pp| -3- m 

VO CO ov < 

m u o u u. 
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HEX TO DECIMAL CONVERSION 
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SUMMARY OF FLAG OPERATION 

[s|z|x|h|x|p/v(n | c1 

Sequence of flags in F register 


VER.V09F 


PAGE 9-7 




APPENDIX 


SECTION 9.4 



VER.V09F 


PAGE 9-8 


APPENDIX 


SECTION 9.4 





VER.V09F 







APPENDIX 


SECTION 9. 



VER.V09F 


PAGE 9-12 




APPENDIX 


SECTION 9.4 





klO 111 /) •! iKMitm t 


VER.V09F 


PAGE 9-13 








APPENDIX 


SECTION 9.^ 


OBJ 

CODE 

SOURCE 

STATEMENT 

OPERATION 

BE 

AOC 

A.IHLI 

Add with Cairv Opar 

D08E05 

ADC 

A,IIX*dl 

and to Acc 

F08E05 

ADC 

A,IIY»dl 


8F 

AOC 

A. A 


88 

ADC 

A.B 


89 

ADC 

A,C 


8A 

ADC 

A.O 


88 

ADC 

A.E 


8C 

AOC 

A.H 


8D 

ADC 

A,L 


CE20 

ADC 

A.n 


ED4A 

ADC 

HL.BC 

Add with Carry Reg 

E05A 

ADC 

HL.OE 

Pair to HL 

ED6A 

AOC 

HL.HL 


E07A 

ADC 

HL.SP 


86 

ADO 

A.IHLI 

Add Opetartd to Acc 

008606 

ADD 

A.IIX^dl 


F08605 

ADO 

A,(IY+d) 


87 

ADD 

A, A 


80 

ADO 

A.B 


81 

ADD 

A.C 


83 

ADO 

A.D 


83 

ADO 

A.E 


84 

ADD 

A.H 


85 

ADD 

A.L 


C630 

ADO 

A.n 


09 

ADD 

HL.BC 

Add Reg Pair to HL 

19 

ADO 

HL.DE 


29 

ADD 

HL HL 


39 

ADO 

HL.SP 


0009 

ADO 

lX.BC 

Add Reg Pair to IX 

0019 

ADO 

lX.OE 


0029 

ADO 

lX.IX 


0039 

ADO 

lX.SP 


FO09 

ADO 

lY.BC 

Add Reg Pair to lY 

F019 

ADO 

lY.OE 


F029 

ADO 

lY.IY 


F039 

ADO 

lY.SP 


A6 

AND 

IHU 

Logical 'AND' ol 

OOA606 

AND 

IIX*dl 

Operand and Acc 

FOA605 

AND 

(lY+dl 


A7 

AND 

A 


AO 

AND 

B 


A1 

AND 

C 


A2 

AND 

0 


A3 

AND 

E 


A4 

AND 

H 


A5 

AND 

L 


E630 

AND 

n 


CB46 

BIT 

O.IHLI 

Tett Bit b of Location 

OOC80546 

BIT 

O.IIX^dl 

or Reg 

FOCB0546 

BIT 

O.IIY*d» 


CB47 

BIT 

O.A 


C840 

BIT 

O.B 


CB41 

BIT 

0,C 


CB42 

BIT 

O.D 


CB43 

BIT 

O.E 


CB44 

BIT 

OH 
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OBJ 

CODE 

SOURCE 

STATEMENT 

OPERATION 

CB45 

CB4E 

DDCB054E 

BIT 

BIT 

BIT 

0 L 

1 IHLI 
1.IIX«dl 

T«l B-i b ol Local.on 
0. Reg 

FDCB064E 

BIT 

1.IIY»dl 


CB4F 

BIT 

l.A 


CB48 

BIT 

1.B 


CB49 

BIT 

1.C 


CB4A 

BIT 

1.D 


CB4B 

BIT 

1.E 


CB4C 

BIT 

1.H 


CB40 

BIT 

1.L 


CBS6 

BIT 

2.IHLI 


DOCB0656 

BIT 

2.IIX*dl 


PDCB0556 

BIT 

2.IIV*dl 


CB57 

BIT 

2.A 


CBSO 

BIT 

2.B 


CBS1 

BIT 

2.C 


CBS2 

BIT 

2.0 


CB53 

BIT 

2.E 


CB64 

BIT 

2.H 


CB65 

BIT 

2.L 


CBSE 

BIT 

3.IHLI 


OOCBOS6E 

BIT 

3.IIX«dl 


F0CB055E 

BIT 

3.«IY*d| 


CB6F 

BIT 

3.A 


CB58 

BIT 

3.B 


CB59 

BIT 

3.C 


CBSA 

BIT 

3.0 


CB5B 

BIT 

3.E 


CB5C 

BIT 

3.H 


CBSO 

BIT 

3.L 


CB66 

BIT 

4.IHLI 


OOCBOS66 

BIT 

4.IIX«dl 


FDCB0S66 

BIT 

4.(IY«d) 


C867 

BIT 

4 A 


CB60 

BIT 

4.B 


CB61 

BIT 

4.C 


CB63 

BIT 

4.0 


CB63 

BIT 

4.E 


CB64 

BIT 

4.H 


CB65 

BIT 

4L 


CB6E 

BIT 

S.IHLI 


O0CB056E 

BIT 

5.(IX*dl 


FOCBOS6E 

BIT 

S.(IY*dl 


CB6F 

BIT 

S A 


CB68 

BIT 

SB 


CB69 

BIT 

S.C 


C86A 

BIT 

SO 


CB6B 

BIT 

SE 


CB6C 

BIT 

SH 


CB60 

BIT 

6 L 


CB76 

BIT 

6 IHLI 


OOCBOS76 

BIT 

eilX.dl 


FDCB0576 

BIT 

6.IIY«dl 


CB77 

BIT 

6 A 


CB70 

BIT 

6.B 


CB7I 

BIT 

6C 


CB73 

BIT 

6.0 


CB73 

BIT 

6 E 


CB74 

BIT 

6 H 


CB75 

BIT 

6 L 


CB7E 

BIT 

7 IHU 


00CB0S7E 

BIT 

7.IIX*dl 
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OBJ 

CODE 

SOURCE 

STATEMENT 

OPERATION 

FOCB057E 

BIT 

7.tlY»dl 

Te»l Bit b LoMtion 

CB7F 

BIT 

7 A 

or Rej 

CB78 

BIT 

7 B 


CB79 

BIT 

7C 


CB7A 

BIT 

70 


CB7B 

BIT 

7 E 


CB7C 

BIT 

7 H 


CB70 

BIT 

7 L 


0C8405 

CALL 

C.nn 

Call Subiouime at 

FC8405 

call 

M.nn 

Locatiort on il Condi 

048406 

CALL 

NC.nn 

t*oii True 

C48405 

CALL 

NZ nn 


F 48405 

call 

P.nn 


EC8406 

CALL 

PE. on 


E48406 

CALL 

PO.nn 


CC8405 

CALL 

Z.nn 


COB406 

call 

on 

Unconditional Call to 
Subroutine at nn 

3F 

CCF 


Complement Carry 

flag 

BE 

CP 

(HLI 

Compare Operand 

OOBE05 

CP 

UX.dl 

Mi|h Acc 

FDBEOS 

CP 

MY.dl 


BF 

CP 

A 


B8 

CP 

B 


B9 

CP 

C 


BA 

CP 

0 


BB 

CP 

E 


BC 

CP 

H 


BO 

CP 

L 


FE20 

CP 

n 


E0A9 

CPD 


Compare Location 
IHL) and Acc 
Oecrement HL and BC 

E0B9 

CPDR 


Compare Location 
IHLI and Acc Oecre 
ment HL and BC. 
Repeat until BC > 0 

E0A1 

CPI 


Compare Location 
IHL) and Acc , Incre 
ment HL and Oecre 
ment BC 

E0B1 

CPIR 


Compare Location 
IHLI and Acc Incre- 
ment HL, Decrement 
BC. Repeat until 
BC > 0 

2F 

CPL 


Complement Acc IV* 
Comp) 

27 

daa 


Decimal Adjust Acc 

35 

DEC 

IHLI 

Oecrement Operand 

D03505 

OEC 

IIX*d» 


FD3605 

DEC 

(lY+d) 


30 

OEC 

A 


05 

OEC 

B 


OB 

OEC 

BC 


00 

OEC 

C 


IS 

OEC 

0 


IB 

OEC 

OE 
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OBJ 

CODE 

SOURCE 

STATEMENT 

OPERATION 

10 

OEC 

E 

Oecrement Oparartd 

25 

OEC 

H 

2B 

OEC 

HL 


007B 

OEC 

IX 


F02B 

OEC 

lY 


20 

OEC 

L 


3B 

OEC 

SP 


F3 

01 


Otiable Interrupt* 

102E 

OJNZ 

* 

Oecrement B at>d 
Jump Reiainre il B ^0 

FB 

El 


Enable Interrupt* 

E3 

EX 

ISPl.HL 

Exchange Location 

00E3 

EX 

ISPl.lX 

and ISPI 

F0E3 

EX 

ISPI.IY 


OB 

EX 

AF.AF- 

Eactiange the Con 
tenttol AF and AF' 

EB 

EX 

OE.HL 

E achange the Con 
tent* ol OE and HL 

09 

EXX 


E (Change the Con 
tent* ot BC OE HL 
WMlh Content* ol 
BC .OE .HL Retpec 
lively 

76 

HALT 


HALT IMait lor Inter 
rupt or Retell 

E046 

IM 

0 

Set Interrupt Mode 

E0S6 

IM 

1 


EOSE 

IM 

3 


E078 

IN 

A ICI 

Load Reg with Input 

E040 

IN 

B.ICI 

Irom Oevicc ICI 

ED48 

IN 

C.ICI 


ED50 

IN 

O ICI 


ED58 

IN 

E.ICI 


E060 

IN 

H ICI 


ED68 

IN 

L.ICI 


34 

INC 

IHLI 

Incremenl Operand 

003405 

INC 

IlX.d) 


F 03405 

INC 

IIY.dl 


3C 

INC 

A 


04 

INC 

B 


03 

INC 

BC 


oc 

INC 

C 


14 

INC 

0 


13 

INC 

OE 


1C 

INC 

E 


34 

INC 

H 


33 

INC 

HI 


0023 

INC 

IX 


FD33 

INC 

IV 


3C 

INC 

L 


33 

INC 

SP 


DB70 

IN 

A l<il 

Iii.hIAi> With 
liiinit liiiKi Dwhk .1 

CUAA 

INI) 


IlkHl IlH.llllHI IH| 1 
with liiimi liimi Pni- 
K;I Drsiivnvnl Ht 
mil H 
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OBJ 

CODE 

SOURCE 

STATEMENT 

OPRRTION 

EDBA 

INDR 


Load Location IHLI 
with Input Irom Port 
ICI. Oeciemant HL 
and Decrement B, 
Repeat until B 0 

EDA? 

INI 


Load Location (HL) 
with Input Irom Port 
1C) Increment 
HL and Decrement B 

EDB2 

INIR 


Load Location IHLI 
with Input from Port 
1C). Increment HL 
and Decrement B. 
Repeat until B 0 

E9 

JP 

IHLt 

Unconditional Jump 

00E9 

JP 

UXI 

to Location 

C38406 

JP 

nn 


FDE9 

JP 

(lYI 


DA8406 

JP 

C.nn 

Jump to Location if 

FA8406 

JP 

M.nn 

Condition True 

078406 

JP 

NC.nn 


C28405 

JP 

NZ,nn 


F28406 

JP 

P,nn 


EA8405 

JP 

PE.nn 


E28405 

JP 

PO.nn 


CA8406 

JP 

Z.nn 


382 E 

JR 

C.e 

Jump Relative to 

302E 

JR 

NC.e 

PC>e if Condition 

202E 

JR 

NZ.c 

True 

282E 

JR 

Z.t 


182E 

JR 

* 

Uncortditional Jump 
Relative to PC+e 

02 

LD 

ItfCl.A 

Load Source to Des 

12 

LO 

IDEI.A 

t melton 

77 

LD 

IHLI.A 


70 

LD 

IHD.B 


71 

LD 

(HD.C 


72 

LD 

(HLI.O 


73 

LO 

(HL).E 


74 

LD 

IHLI.H 


75 

LD 

IHLI.L 


3620 

LD 

(HLl.n 


DD7705 

LD 

(IX>d).A 


007005 

LD 

UX*d).B 


007106 

LO 

IIX*d(,C 


007206 

LD 

(IX+d».D 


007306 

LD 

(IX>d).E 


007405 

LD 

IIX«dl.H 


007505 

LD 

IIX»d».L 


00360520 

LO 

(IXad).n 


F07705 

LD 

(IY*d(.A 


F 07005 

LO 

IIV*dl,B 


F07105 

LO 

(IY*dl,C 


F 07205 

LD 

IIY«dl.D 


FO7305 

LO 

IIY*dl.E 


F 07405 

LD 

(IY+d».H 


F 07505 

LD 

UY+d).L 


F 0360520 

LO 

IIY+dl.n 


328406 

LO 

Inn) .A 


E 0438405 

LD 

(nnl.BC 
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CODE 
ED53840S 
728406 
D0278406 
F 0778406 
6 0738406 
OA 
1A 


007E06 

F07E06 

3A8406 


LO Innl.OE 

LD (nnt.HL 

<-D lnn).IX 

•-0 (nn).IY 

LO Innl.SP 

1-0 A (BCI 

LO A.IOEI 

LO A.(HL» 

LO A.IIX^dl 

LO A.|IY*dl 

LO A.(nn) 


LO 

LO 


A. A 
A.B 


3E70 

EOSF 


004605 
F 04606 


0670 

E04BB405 

01B405 

4E 

004 E06 
F04E06 


LO A.L 

LO A.n 

LO A.R 

LO B.(HL) 

LO B.(IX«dl 

LO B,IIY*d( 

LO B.A 

LO b.B 

LO B.C 

LO B.O 

LD b.E 

LO B H 


LO BC.(nnl 

LO BC.nn 

LO C,(HLI 

LO C.(IX4dl 

LO C.UY.dl 

LO C.A 

LD C.B 

LO C.C 

LO c,0 


LD 

LD 


C.E 

C.H 


LD 0.(HU 

LD 0.(IX*dl 


LD DC 

LD 0,D 


1670 

E05B8405 

118406 


LO o.H 
LD OL 

LD o.n 

LO OE (nnl 

LO OE.nn 

LO E.IHLI 

LO E.(IX*dl 

LO E.(IY»d( 

LD E A 

LD E.B 


OPERATION 
Load Sourca to Oh- 
lination 


VER.V09F 



APPENDIX 


SECTION 9.M 


OBJ 

CODE 

SOURCE 

STATEMENT 

OPERATION 


5A 

LO 

E.O 

Load Source to Dei- 


SB 

LO 

E.E 

tmaffon 


SC 

LO 

E.H 



SO 

LO 

EL 



1E20 

LO 

E.n 



66 

LO 

H.IHLI 



DO6605 

LO 

H.(IX+dl 



F0660S 

LO 

H.dVidI 



67 

LO 

H.A 



60 

61 

LO 

LO 

h;c 



62 

LO 

H.O 



63 

64 

LO 

LO 

HE 



6S 

LO 

H.L 



2620 

LO 

H.n 



2A840S 

LO 

HLInnl 



218405 

LO 

HL.nn 



ED47 

LO 

I.A 



OD2A840S 

LO 

IX.(nn) 



00218405 

LO 

lX.nn 



F02A8405 

LO 

IV.(nn> 



F0218405 

LO 

lY.nn 



6E 

LO 

L,(HL) 



OO6E05 

LO 

L.(IX>dl 



F06E05 

LO 

L.tlV*d» 



6F 

68 

LO 

LO 

LA 

L.B 



69 

LO 

L.C 



6A 

LO 

L 0 



68 

LO 

L.E 



6C 

LO 

L.H 



60 

LO 

L,L 



2E20 

LO 

L,n 



E04F 


LO R.A 



EO7B8405 

LO 

SP.Innl 



F9 

LO 

SP.HL 



DDF9 

LO 

SP.IX 



F0F9 

LO 

SP.IY 



318405 

LO 

SP.nn 



E0A8 

LOO 


Load Location (DEI 
with Location IHLI. 
Oecrement OE.HL 
and BC 


E0B8 

LDOR 


Load Location lOEl 
with Location IHL), 
Rspaat until BC • 0 


EOAO 

LOI 


Load Location lOEl 
with Location (HLI. 
Increment OE.HL. 
Decrement BC 


EOBO 

LOIR 


Load Location (DEI 
with Location IHLI. 
Increment OE.HL. 
Decrement BC ar>d 
Repeat until BC “ 0 


E044 

NEC 


Negate Acc (2 i 
Complement! 


00 

NOP 


No Operation 


B6 

OOB60S 

OR 

OR 

IHL( 

UX*d) 

Logical "OR" ol 
Operand and Acc 
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OBJ 

CODE 


FOB605 

B7 

BO 

81 

B2 

83 

84 

85 
F620 

OR (IY*dl Logical "OH" ol 

OR A Operand and Acc 

OR 8 

OR C 

OR 0 

OR E 

OR H 

OR L 

OR n 

E08B 

OTOR Load Output Port (Cl 

with Location IHLI 
Decrement HL and 8. 
Repeat until 8 • 0 

EOB3 

OTtR Load Output Port (Cl 

with Location (HL). 
Increment HL, Deere 
ment 8. Repeat until 
8 <0 

E079 

ED41 

ED49 

ED51 

EOSS 

E061 

E06B 

OUT (CI.A Load Output Port (C) 

OUT (CI.B with Reg 

OUT (CI.C 

OUT (CI.D 

OUT (CI.E 

OUT (CI.H 

OUT (CI.L 

0320 

OUT inl.A Load Output Port (nl 

with Acc 

EOAB 

OUTO Load Output Port (Cl 

with Location IHLI. 
Decrement HL and 8 

EOA3 

OUTI Load Output Port (Cl 

with Location (HLI. 
Increment HL and 
Decrement B 

FI 

Cl 

01 

El 

OOE1 

FOE1 

POP AF Load Oettmation 

POP BC with Top of Stack 

POP DE 

POP HL j 

POP IX 1 

POP lY 1 

F5 

CS 

OS 

ES 

DOES 

FOES 

PUSH AF Load Source to Stack I 

PUSH BC 1 

PUSH DE 1 

PUSH HL 1 

PUSH IX 1 

PUSH IV 1 

CB86 

0DC60S88 

FDC80586 

CB87 

C880 

CB81 

CB82 

CB83 

CB84 

CB85 

CB8E 

OOCBOS8E 

F0CB0S8E 

CB8F 

RES O.IHLI ReietBithot 1 

RES O.IIXrdI Operand 1 

RES O.llYrdl 1 

RES O.A 1 

RES O.B 1 

RES O.C 1 

RES 0.0 M 

RES OE 1 

RES OH 1 

RES O.L 1 

RES 1 IHLI 1 

RES ItlXid) 1 

RES IllVirti 1 

HtS 1 A 1 
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oej 

coot 

CB88 

CB88 

CB8A 

CB8B 

CB8C 

CB80 

CB96 

00C80696 

FOCB0696 

CB97 

CB90 

CB9) 

C892 

CB93 

CB94 

CB95 

CB9E 

OOCBOS9E 

FDCB0S9E 

CB9F 

CB98 

CB99 

CB9A 

CB9B 

CB9C 

C890 

CBA6 

OOCeOSAS 

FOCB05A6 

CBA7 

CBAO 

CBA1 

CBA3 

OBA3 

CBA4 

CBA5 

CBAE 

OOCB06AE 

FDCB05AE 

CBAF 

CBA8 

CBA9 

CBAA 

CBAB 

CBAC 

CBAO 

CBB6 

ODCB05B6 

FOCB05B6 

CBB7 

CBBO 

CBB1 

C8B2 

CBB3 

C8B4 

CBBS 

CBBE 

D0CB058E 

FDCB05BE 

CBBF 

CBB8 

CBB9 

CBBA 


SOURCE 

BTAT6M6WT 

RES 1.B 

RES 1.C 

RES 1.0 

RES 1 .E 

RES 1 H 

RES 1.C 

RES 2.(HU 

RES 2.IIX*dl 

RES 2.(IV*d) 

RES 2.A 

RES 2.B 

RES 2.C 

RES 2.0 

RES 2.E 

RES 2.H 

RES 2.L 

RES 3.IHLI 

RES a.IIX^dl 

RES 3.tlY*dl 

RES 3.A 

RES 3.B 

RES 3,C 

RES 3.0 

RES 3.E 

RES 3.H 

RES 3.L 

RES 4.(HL» 

RES 4,(IX^dl 

RES 4.(IY*d) 

RES 4. A 

RES 4 B 

RES 4.C 

RES 4.0 

RES 4.E 

RES 4.H 

RES 4.L 

RES 5.1HU 

RES S.(IX*dl 

RES 5.(IY*dl 

RES 5.A 

RES 5.B 

RES 5.C 

RES 5.0 

RES 5.E 

RES S.H 

RES 5.L 

RES 6.(HU 

RES e.llX^dl 

RES B.IIY+dl 

RES 6.A 

RES 6.B 

RES 6.C 

RES 6.0 

RES 6.E 

RES 6H 

RES 6 L 

RES 7.IHU 

RES 7.(IX+dl 

RES 7.(IY+d) 

RES 7, A 

RES 7.B 

RES 7.C 

RES 7.0 


OPERATION 

R«tet Bit b ol 
Operand 


J 
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OBJ 

CODE 

SOURCE 

STATEMENT 

OPERATION 


CBBB 

RES 

7.E 

Rawi Bit b ot 


CBBC 

RES 

7.H 

Operand 


CBBO 

RES 

7.L 



C9 

RET 


Return from 





Subroutine 


OB 

RET 

C 

Return from 


FB 

RET 

M 

Subroutine •( Condi 


00 

RET 

NC 

tion True 


CO 

RET 

N2 



FO 

RET 

P 



E8 

RET 

PE 



EO 

RET 

PO 



CB 

RET 

Z 



E040 

RETI 


Return from Interrupt 


E04S 

HETN 


Return Ifom Non 





Inmrupt 


C816 

RL 

(HLI 

Rotate Lett Throuoh 


00CB0S16 

RL 

IIX*dt 

Carry 


FOCB0516 

RL 

IIY.dl 



CB17 

RL 

A 



CB10 

RL 

B 



can 

RL 

C 



C612 

RL 

0 



CB13 

RL 

E 



CB14 

RL 

H 



C815 

RL 

L 



17 

RLA 


Rotate Left Acc 





Through Carry 


CB06 

RLC 

(HLI 

Route Lett Circular 


0OCB0506 

RLC 

IIX«dl 



FOCB0SO6 

RLC 

HY*d) 



CB07 

RLC 

A 



CBOO 

RLC 

B 



CB01 

RLC 

C 



CB02 

RLC 

0 



CB03 

RLC 

E 



CB04 

RLC 

H 



CB05 

RLC 

L 



07 

RLCA 


Route Lett Cucular 





Acc 


E06F 

RLO 


Rotate Oigit Lett and 





Right between Acc and 





and Location IHLI 


CB1E 

RR 

IHLI 

Route Right Through 


OOCBOS1E 

RR 

IIX«d» 

Carry 


F0CB0S1E 

RR 

(IY*d) 



CB1F 

RR 

A 



CB18 

RR 

B 



CB19 

RR 

C 



CBIA 

RR 

0 



CBIB 

RR 

E 



CB1C 

RR 




CB10 

RR 

L 



IF 

RRA 


Rotate Right Acc 





Through Caiiy 


CBOE 

RRC 

IMLI 

Rotate Right Circular 


0DCB050E 

RRC 

IIX*dt 



FOCBOSOE 

RRC 

IIY*dl 



CBOF 

RHC 

A 
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OBJ 

CODE 

SOURCE 

STATEMENT 

OPERATION 

CBOB 

RRC 

B 

Rotate Right Orcular 

CB09 

RRC 

C 


CBOA 

RRC 

0 


CBOB 

RRC 

E 


CBOC 

RRC 

H 


CBOO 

RRC 

L 


OF 

RRCA 


Rout* Right Circular 
Acc 

E067 

RHO 


Rotate Otgtt Right and Lett 
Between Acc. end Location (HLI 

C7 

RST 

OOH 

Rettart to Location 

CF 

RST 

08H 


07 

RST 

10H 


OF 

RST 

IBM 


E7 

RST 

20H 


EF 

RST 

28H 


F7 

RST 

30H 


FF 

RST 

38H 


9E 

SBC 

A.IHLI 

Subtract Operand 

009E05 

SBC 

A.(IX+d) 

from Acc with Carry 

FD9E0S 

SBC 

A.(IY*dl 


9F 

SBC 

A.A 


98 

SBC 

A.B 


99 

SBC 

AC 


9A 

SBC 

AO 


9B 

SBC 

A.E 


9C 

SBC 

A,H 


90 

SBC 

A.L 


OE20 

SBC 

A.n 


E042 

SBC 

HL.BC 


E052 

SBC 

HL.DE 


E062 

SBC 

HL.HL 


E072 

SBC 

HL.SP 


37 

SCF 


Set Carry FlagIC- 1) 

C8C6 

SET 

0,(HL) 

Set Bit b ol Location 

OOCB06C6 

SET 

O.IIX^d) 


FOCB05C6 

SET 

O.tlY^dl 


CBC7 

SET 

O.A 


CBCO 

SET 

O.B 


CBC1 

SET 

o.c 


CBC2 

SET 

0.0 


CBC3 

SET 

O.E 


CBC4 

SET 

O.H 


CBC5 

SET 

O.L 


CBCE 

SET 

1,<HLt 


OOCB05CE 

SET 

1.(IX+d( 


FOCB05CE 

SET 

1.(IY*d) 


CBCF 

SET 

1.A 


C8C8 

SET 

t.B 


CBC9 

SET 

»,c 


C8CA 

SET 

1.0 


CBCB 

SET 

1.E 


CBCC 

SET 

l.H 


CBCO 

SET 

1.L 


CB06 

SET 

2.(HLI 


OOCB0SO6 

SET 

2.(IX*dl 


FOCB0SO6 

SET 

2,IIY*dl 


CB07 

SET 

2.A 


CBOO 

SET 

2.B 


CBOt 

SET 

2.C 


CB02 

SET 

2.0 
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OBJ 

COPE 


SOURCE 

STATEMENT 


C803 

C804 

C805 

CB08 

CBOE 

ODCBOSOE 

EOCB050E 

CBOF 

CB09 

CBOA 

CBOB 

CBOC 

CBOO 

CBE6 

OOCB05E6 

FOCB08E6 

CBE7 

CBEO 

CBE1 

CBE3 

CBE3 

C8E4 

CBES 

CBEE 

0DCB05EE 

FOCBOSEE 

CBEF 

CBES 

CBE9 

CBEA 

CBEB 

CBEC 

CBEO 

CBF6 

OOCBOSF6 
F0CB05F6 
CBF7 
CBFO 
CBF1 
C8F3 
CBF3 
CBF4 
CBF5 
CBFE 
00CB05FE 
FOCBOSFE 
CBFF 
CBF8 
CBFB 
CBFA 
CBFB 
CBFC 
CBFD 
CB36 
OOCBOS26 
F0CB0S36 
CB27 
C820 
CB3I 
CB23 
CB23 
CB24 
CB2S 


SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SLA 

SLA 

SLA 

SLA 

SLA 

SLA 

SLA 

SLA 

SLA 

SLA 


3.IHU 

3.(IX*dl 

3.(IY.c« 


4.IHLI 

4.(IV*dl 


S.(HL) 

S.(IX*dJ 

5IIY*d) 


B.IMLI 

e.(ix«di 

6,(IY*dl 


7.(HL) 

7.(IX«d) 

7.0Y»d) 


<HL) ShiM Operand Lett 

ttX»dl Arithmetic 

IlYrdl 
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Example Values 


nn 

EQU 

584H 

d 

EQU 

5 

n 

EQU 

20H 

e 


30H 
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DEMONSTRATION PROGRAMS 


9.5.1 PROGRAM 1 


5 CUROFF 

10 FC»I»lT05OiNEXTIj SCREEN! 

20 F 0 RI=iT 0 iaSTEP 2 
30 CIRCLE (O, 0> , 1, 1 
40 CIRCLE (239,0) , 1,1 
50 CIRCLE (0,63) , 1,1 
60 CIRCLE (239, 63) ,1,1 
70 NEXT I 
80 CHAR2 
90 L0CATE4,! 

100 PRINT-DVW" 

110 CHARI 

120 l(x:ateii,i 

130 PRlNT‘*nicroel»ctronics’‘ 

140 LOCATE 12, 2 
150 PR I NT** present s’* 

160 CHAR4 

170 L0CATE9,3 

IBO PRlNT-)ftJSKY SP" 

190 F0RI»1T0110OiNEXTI 
200 CLS 
210 CHAR3 
220 LOCATE 1 2, 1_ 

230 PRINT-HISH RES" 

240 L0CATE12,3 
250 PRINT-BRAPHICS- 
260 F0R1«1T0999:NEXTI 
270 CLS 

280 FORI-OT03OSTEP2 
290 CIRCLE (120, 31) , I 
300 NEXT I 

310 F0RI»1T031STEP2 
320 CIRCLE(120,31) ,I 
325 SOUND 1,100 
330 NEXT I 

340 FOR 1*31 TO 1 STEP-2 
350 CIRCLE (120, 31) ,1,0 
355 S(X»ND 1,100 
360 NEXTI 

370 F0RI-30T00STEP-2 
380 CIRCLE(120,31) ,1,0 
390 NEXTI 
392 CLS 

395 FORI-lTOlOO: NEXTI 

4(X» LINE(99,63-41)-(126,63-27) ,1,BF 

402 LINE (96,63-44)- (133,63-24) ,1 ,B 

403 LINE (96, 63-44 >-(92,63-48) 

404 LINE(133,63-44)-(129, 63-48) 

405 LINE(96,63-24>- (92,63-28) 

406 LINE (92,63-48) -(129,63-48) 

407 LlNE(92,63-48)- (92,63-28) 

408 FSET ( 130, 63-28) ,( 130,63-30) ,( 130,63-32) ,( 130 63-34) 

409 LINE(131,63-24)-(131, 63-10) « I iO,6Z 34 ) 

410 LINE(98,63-24)-(98, 63-10) 

411 LINE(94,63-26)-(94,63-14> 

412 LINE(127, 63-24)- (127,63-14) 

413 LINE(98,63-17)-(13I, 63-17) 

414 LINE(9B. 63-17)- (94,63-21) 
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415 LlNEa31,63-17)-(127, 63-21) 

416 LINE(94,63-21)-<127, 63-21) 

417 FQRl=lT0999iNEXT 

418 LINE(100,63-40)-<125, 63-28) ,0,BF 

419 CHARO 

420 F0RJ=1T030 

421 L0CATE18,4 

422 PRINT-DVW" 

423 LINE (101 ,63-30) -<124,63-30) 

425 NEXTJ 

426 LINE (99, 63-41) -(126, 63-27) ,1,BF 
470 F0R1=1T0250:NEXTI 

480 CLS 

490 F0RI-0TQ63 

500 LINE(56,I)-(1B3,I) 

505 50UND64-I,100 

510 NEXTI 

520 FOR I =01063 

530 LINE(119,63)-(119-I,0) ,1+1 

540 LINE(120,63)-(120-»-I,0),I-H 

550 NEXTI 

560 F0RI»0T063 

570 LINE(119,63)-(56,I) ,1+1 

580 LINE(120,63)-(183,I) ,1+1 

590 NEXTI 

595 F0RI-1T0500: NEXTI 

600 F0RI=0TD63 

610 LINE(119,63)-(56,63-I) 

620 LINE(120,63)-(183,63-I) 

630 NEXTI 

640 F0R1=0T063 

650 LINE(119,63)-(56+I,0) 

660 LINE(120,63)-(183-I,0) 

670 NEXTI 

680 F0RI-63T00STEP-1 

690 Ll^E(56,63-I)-(la3,63-I) ,0 

695 S0UND64-I, 100 

700 NEXTI 

720 CLS 

730 CHARI 

740 L0CATE3,! 

750 PRINT"5 Different character seta" 
765 LINE(16,11)-(224,11) 

767 FORI=lT0200x NEXTI 

770 CHAR4 

700 L0CATE8,3 

790 GOBUBIOOO 

BOO LDCATEB,3 

810 G0SUB1030 

820 CHAR3 

830 LOCATE 12, 3 

840 BOBUBIOOO 

850 LOCATE 12,3 

860 G0BUB103O 

870 CHAR2 

880 -DCATE8,3 

890 GOBUBIOOO 

900 LOCATES, 3 

910 B0SUB1030 

920 CHARI 
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930 LOCATE 12, 3 
940 GOSUBIOOO 
950 LOCATE 12, 3 
960 ETSUB1030 
970 CHARO 
980 LOCATE 17, 4 
990 GOBUBIOOO 

999 GOTO 10 

1000 PRINT"ABCD/Hyz" 
1010 F0RI«1T0999 iNEXTI 
1015 BEEP 

1020 RETURN 
1030 PRINT" 

1040 RETURN 
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9.5.2 PROGRAM 2 


le ClEAR;CUfiOFF:5CREENl 
20 CIRCLEU2B.31I.30 
30 L1NEU19.3)-(U9.6) 

40 LlNEU2t.3J-(12!.6) 

50 LlNE(14S.31)-n4e,3n 
60 LINE(12I.S6)-n20.59) 
el LINE(92.31I-(95.31) 

70 PSETU34.7I.U44.17).U44,45i.(l34.55U10e.55),t9a,45),i9fc,l7l,tl0b,7i 

71 T$=TIMEI:NI=VALiniD$(TI,4,2)l;HR=VHLiLEFTMI.2M:SC=VflLlRI6HlJ(Tl.2l> 

72 AH=Ml«6+270: IFAM/359THEHAH=AH-360 

73 AH=HR»30*270: lFAH)359TriENAH=AH-360 

74 iN=FI > ( 23*C05 1 AH»P 1 / 1801 1 : VH=F H ( 2?t51 N < AH*F M 80) ' 

75 IH=FI » U5*C0S (AH*PI / 180) I : yH=FI K ( IStSlN ( AH*‘>! / 1 00 " 

60 AG=SC«6+270; IFA6 '359THENA6=A6-3e0: T I =500 

90 lFA6>339THENA8=A6-360 
100 Th=AG*PI/lB0 

lie LlNEU20,3U-il2e*llS.3hYS).0 

120 yS=Fn(25*SlNlTH)l;)(S=Fiyi25*COS'THiaLlNEil20,'I--a2eHS,31+YS) 

121 LINE(120,31)-(l20*l(N.31tym 

122 IINE(120.31)-1120UH.31+YH) 

123 CHARI. 1:L0CATE1,1:PRIMT* *:TIHEI;' * 

150 souNDiee,i 0 

155 lFA6=27eTHEN6OSUB200 
160 TU=VAUR16HTflTlHEl.in 
170 IFTI=TUTHENt60 
180 TI=TU:A6=A6H:6OTO90 
200 AH=AHH 

215 IFAH'359THENAH=An-360 
210 TH=AH«PI/180 

220 LINE(120.31)-U20*)IH.3UVH).0 

230 IH=FlU23«COS{TKl)iyH=FII(23»SIMiTHM:LlNEli:0.3l'-(120»KH,31+yH) 

240 IFmN' >27BTHENRETURN 
250 AH=AH*30 

255 IFAH^359THENAH=AH-360 
260 TH=AH(PI/I80 

270 LlNE(12B.31)-U20t7H,3iVfHl,0 

280 IH=Flni5»COS(TH)l;¥H=Fn(15#51M(TH)):LINE(120,3U-(l20*7H,31*fH) 

290 RETURN 



VER.V09F 


PAGE 9-30 


APPEMDIX 


SECnOM 9.5 


9.5.3 PROGRAM 3 


most 


P T I i * , 3i PR I NT •• HUNTER » 

35 line (15,26) -< 14,38> , 1 B 

52 ^e2i-'^*'-aCATEl,4.PRINT« BIS CAPABILITY- 
50 PRINT" small PACKAGE." 

60 LINE(0,0)-< 125,63) , 1 ,B 
70 CHAR0,0iL0CATE23,l:PRlNT"Th. worlds 
90 PPPSI|”’2,PRINT"advanced h:nd hilS" 

90 L0CATE23,3iPRlNT"portable micro 

4: PRINT "HUSKY HUNTER »«’" 

9? , SP«Z5;^ = *'^^NT"CP/M compatible 
93 LOCATE.. j,6:PRlNT"has upto 20BI oi« 

4 L0CATE23, 7: PRINT'Vam and powerful" 

95 L0CATE23 . B. PRINT "commun i cat i on^P " 

100 INCHR"",AiSCREENO 
no KEYOFFiCLS 

120 PRINT" A B r n 

130 0PCHR15,4,0 ° 

160 0PCHR15,21,0,124|l24 
170 0PCHR15, 30,0, 124, 124 
180 F0RI-1TQ7 
190 0PCHR1S,2,I 
200 PRINTSTR*(I);CHR*a24>5 
210 NEXT 


734. 1 > 
543.72 


314.09 

134.07 


45.02 -98.42 

5438.63 
480.76 85.64 

-94.85 

824.64 

9845.49 

3487.45 49.76 


220 0PCHR15, 4,1: PRINT" 

230 0PCHR15,4,2:PRINT" 

240 0PCHR15,4,3iPRlNT" 

250 0PCHR15,4.4jPRINT" 

260 QPCHR15,4,5:PRINT" 

270 0PCHR15,4,6:PRINT" 

200 0PCHR15,4,7jPRINT" 

290 0PCHR15,0,0.PR1NT"' 

295 INCHR"",A:CLS 
300 CIRCLE(44,31) ,31 
310 LINE(44,31)-(66,9) 

320 L1NE(44,31)-(44,62) 

330 LINE(44,31)-(15,41) 

340 CHARO 

350 L0CATE6,3:PRINT"4154" 

360 L0CATE2,1:PRINT“UK“ 

370 L0CATE5,6tPRINT"20X" 

300 L0CATE2,8tPRlNT"USA" 

390 LOCATE 1 0,5; PR I NT "39X" 

400 L0CATE13,7iPRINT"Europe" 

410 CHAR4: LOCATE 14,1; PR I NT "ACME Ltd- 

420 CHARI, ltL0CATEl2,3;PRINT"Prafit . 

430 L1NE(87,26)-(87,38) Distribution 

440 CHARI, 0:L0CATElb,4:PFINT"Fiscal Year" 

450 locate 18, 5; PR I NT "I 903-84" 

460 1NCHR"",A;SCREEN0 
500 SCREEN 1 

SIO line ( 0,0) -(239, 63), l.B 
520 FORI «0T0239STEP8 
530 PSET(I,59) 


798.11"; 

764.11"; 

45.23"; 

407.45"; 
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I 

li 

r 

I, 

|: 


S40 PS£TtI-.l,60> , CI+2,60) ^( 1 * 6 , 60 ) , (1*7, 60) 
530 PSET(1^3, 61), (1-4,61), (1-^5,6J) 

560 NEXT 

570 LlNE(50,60)-(45,50) 

380 LINE(45,30)-<45,46) 

590 LI)«(45,46)-(39,40) 

600 LINE(39,41)-<34,46) 

610 LINE-(37,49) 

620 LINE- (42,44) 

630 LINE(4S,46)-(62,46) 

640 PSET <63, 47) , (63,48) , (64,49) 

650 LINE(45,50)-(130,30) 

660 PSETdSl ,49) , (152,48) , (132,47) , (153,46) 
670 LINE(153,46)-(173,46) 

680 LINE (173,46) -(155,60) 

690 L1NE(173,46)-(194,40) 

700 LINE (145,30) -(145, 10) 

710 L1NE(145,10)-(193,40) 

720 LINE(71,30)-(71,13) 

730 LlNE(71,15)-(43,46) 

740 LINE (108,50) -(108,1) 

750 LINE(108,1)-(71,15) 

760 LIN£(108,1)-(145,10) 

770 LlNE(61,24)-(78,20) 

780 LINE (58,39) -(84,34) 

790 LINE(98,11)-(115,7) 

800 LIIME(93,25)-(121.20) 

810 L1NE(92,42)-(127,36) 

820 LINE(135, 19)-(152, 15) 

830 LINE(132,34)-( 158,29) 

840 FORI=64T0150STEP10 
850 PSET (I, 53) 

860 NEXT 


156,49) , (157,53) , (158,53) , (159,52) 


870 LINE(160,48)-(156,32) 

880 PSET(155,51) , (155,50) , 

890 PSET ( 158,48) , (160,50) 
aZi » (37,17) , (36, 16) , (35, 16) , (34,16) , <33, 17) 

892 PSET (38, 16) , (39, 16) , (40, 16) , (41 , 17) 

893 CIRCLE(0,0),15 

’ (210,50) , (209,49) , (208,49) , (207,49) , (206,50) 

893 PSET(211, 49) , (212,49) , (213,49) , (214,30) 

900 CHARO,I:L0CATE30,2:PRINT"HMS BOUNTY - 
910 LINE(173,7)-(233,15) ,1 ,B 
999 lNCHR*",AsSCREEN0»G0T01 
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9.5.4 


program 4 UNLOAD* 


witn the name UNLOAD.HEX. 


be converted to a *COm‘ ^ to 

following colai^J: ’ ®"ter the 


>load unload. hex 

file enter the folowlng: convert a 

>UNU3AD sourcefile filename. HEX 

be converted^,® the'^M^nd^^^^ 'fneM"me?HErlm 

the INTEL HEX version of the file. * then contain 

te:nsfer?e7dat“\Vi^^^^^^^^ 

command) then this Is not a proUe^ ^AVE n 

O" from 

IBM compaUble diL. ^ ® °r 8" 
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UNLOAD PROGRAM 


;20010000C3340200000000000C»OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOr*Oi;.OOOEc 
*: 200 1 200000000000000000000000i;)0000000000000000000000000000000000000000<:»OOBF 
: 2001400000000000000000000«:i00000000000000000000000000000000000000000000009F 
i 200160000000000000000< X»000000000000000000000000000000000000t:)0000< K'M MjOOOOyF 

:200180000000000000000000000000000000000000000000000000000000000<;)OOr)nOi;i005F 
; 200 1 AOOOOOOOOOOOOOOOO'.iOOO* xiiFiOOOOOOOOOOOOOOOOOOOOOOOtix.iOOOOOOOOOO' X K )ut:.(:»>OC»T.F 
: 200 1 COOOOOOOOOOOOOOOOOOOOCi. K m;)00000000000000000»;»00<:h:m n:»00000000< >. m m m ir»r) I F 

: 2001EOOOOOOOOOOOOOOOOOOOO<:m.m h )0000000000044495343206572726F7224576F 75726362 
;20020000652F6F626A6563742"66t.96C65206572726F7224436F6E76657274696E67202E38 
: 200220002E2E202424436F6D706C65746564202E2E2E20242A06001 10100AFED52E5F ICD9C 
; 200240005E0401 1000216C001 1C601EDB03A6DOOFE20CC3D041 15C000E0FCD05003CCC3DB6 
: 2002600004 1 1C60 1 0E13CD05001 1C6010E16CD05003CCC4F041 1 14020E09CD0500 1 124023F 
: 200280000E09CD05001 180000E1 ACD05001 15COOOE14CD0500B7C41303AF32C5013AC50151 
: 2002A000FE8028E 1 5F3C32C50 1 1 6002 1 8000 i 97ECD9D032 1 OCO 1 06003AC30 1 4F09722373D7 
; 20O2C00OOC0C79FE34280632C30 1 C39D02AF32C30 1 CDC403CDE9032 1 C40 1 7EFE0 1 28 1 036 1 2 
; 2002E00OO 1 2 1 030 111430101 4000EDB0C39D0236002 1 030 1 1 1 830 1 0 1 4000EDB0 1 1 430 1 OE 1 2 
: 20030000 1 ACDO500 1 1 C60 1 OE 1 5CD0500B7C44F04C39D022 1 OCO 1 06003 AC30 1 4F 09FE3428 1 0 
: 200320000636302 33C1800CDC403CDE9033AC401F5FE0 128051 14301 18031 1830121030143 
I 200340000 1 4OOOEDB0F 1 FEO 1 280C3E0 1 32C40 1 2 1 OCO 1 3E00 1 8C7 1 1 430 1 OE 1 ACD0500 1 1 C6F4 
; 200360000 1 OE 1 5CD0500B7C44F04067F 3E002 14401 7723 1 0FC060C2 14401 3E307723 1 0FC5F 
: 200380002150013E1A771 1C6010E15CD0500B7C44F041 1C6010E10CD0500C34604F5E60FC2 
: 2003A000FE0AF AA903C637 1 802F6305FF 1 CB 1 FCB I FCB 1 FCB 1 FE60FFE0AFAC003C63757C983 
:2O03COOOF63O57C92AEE01 1 1 1A001922EE01E57CCD9D037A3206017B320701F17DCD9D036U 
: 2003E0007A32080 1 7B32090 1 C92 1 040 1 06 1 E 1 1 00O0AF7E4F237E23FE4OF AFE03D607E60F22 
: 20040000835F 1717171 7F57BE60F5F79FE40F A 1 304D607E60F8257F 1 3E008A57 1 0D37BE6 1 3 
: 200420000F5F7A 1717171 7E6F0B3ED44CD9D037A32400 1 7B324 1 0 1 3E0D32420 1 C9 1 1 FBO 1 DF 
: 20044000CD5804C300001 12502CD5804C300001 1F001CD5804C300000E09CD0500C906EAFC 
: 20046000AF2 1 030 1 7723 1 OFC 1 1 24020E09CD05002 1 030 1 363A23363 1 23364 1 2 1 E60022EE 1 2 
: 090480000 1 2 1 OAO 1 3E30772377C7 
: 0000000 IFF 
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in MEMORY LOCATIONS ■ 


Lex: at ion 
(Decimal) 

Location 

(Hex) 

Name 

Function 


55043 

55046 

55049 

55052 

55055 

55058 

55061 

D703 

D706 

D709 

D70C 

D70F 

D712 

D715 

JMP WARMSTART 
JMP CONSTAT 
JMP CONIN 
JMP CONDUT 
JMP UST 
JMP PUNCH 
JMP READER 

CP/M BIOS jump t^le 


55296-55424 

D800-DF80 VERSCRN 

Virtual screen 80 x 24 characters D800 
is the top left hand comer. 

57344-61439 

EOOO-EFFF 

Operating system area. 


61440-62463 

F00(^F3FF 

I/O Buffers. 


62981-63061 

F605-F655 USER 

This Ram area is left free by 
operating system and is vailable 
use as user machine code routines. 

the 

for 

63168-63359 

F6C0-F77F 


0/S Stacks. 


63360 

F780 

IPFUG 

Logical keyboard flag: 

0 = HUNTER keyboard/LCD screen 
128(80H) = Serial I/O port 


63364 

F784 

VECTOR 

HELP vector address. The key is 
trapped by the keyboard softwear and is 
vectored to this location. 

63415 

F7B7 

APHRO 

Flag to indicate how HUNTER was powered 


63416 


63419 


F7B8 NYMPHO 


F7BB FOREVER 


0 = Keyboard 

1 = Serial port 

2 = Clock 

If the standard power down routine is 
used then setting this byte non-zero 
will inhibit operation of the power off 
key. 

NOTE: This byte is cleared on power up. 

Setting non-zero prevents automatic 
switch off after time-out. 
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Legation 

(Decimal) 

Location 

(Hex) 

Name 

Function 

63M6^I 

63465 

63466 

63467 

63468 

63469 

63470 

F7E8 

F7E9 

F7EA 

F7EB 

F7EC 

FTED 

F7EE 

TENTHSEC 

UNITSEC 

TENSEC 

UNITMIN 

TENMIN 

UNITHRS 

TENHRS 

Time memory 1/10 sec. 

” »» unit sec. 

M »' tens sec. 

« '» unit mins, 

n '• tens mins. 

« ’» unit hours. 

« ” tens hours. 

63471 

63472 

63473 

63474 

63475 

63476 

F7EF 

F7F0 

F7F1 

F7F2 

F7F3 

F7F4 

UNITDAY 

TENDAY 

UNimiH 

TENMTH 

UNITYR 

TENYR 

« " unit days. 

•» » tens days. 

” ” unit month. 

« " tens month. 

»' •' unit years. 

" " tens years. 

63480 

F7F8 

TXSPEED 

Set serial 0/P baud rate: 

1 = 75 4 = 300 7 = 1800 

2 =-110 5 = 600 8 = 2400 

3 = 150 6 = 1200 9 = 4800 

63481 

F7F9 

RXSPEED 

Set serial I/P baud rate ( 
(TXSPEED). 

63482 

F7FA 

CTSAF 

The CTS enable flag: 
0 = No 1 = Yes 

63483 

F7FB 

DTRAF 

The DTR enable flag: 
0 = No 1 = Yes 

63484 

F7FC 

RTSAF 

The RTS enable flag: 

0 = No 1 = Hold 2 = True 

63485 

F7FD 

DSRAF 

The DSR enable flag: 
0 = No 1 = Yes 

63486 

F7FE 

DCDAF 

The DCD enable flag: 
0 = No 1 = Yes 

63487 

F7FF 

TXPTY 

Transmit parity flag: 

0 = None 1 = Odd 2 = Even 

63488 

F800 

RXPTY 

Receive parity flag: 

0 = None 1 = Odd 2 = Even 
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Location 

(Decimal) 

Location Name 
(Hex) 

Function 

63489 

F801 

TXPROT 

Transmission protocol; 

0 = None 

1 = XON/XOFF 

2 = ETX/ACK 

3 = ACK/NAK 

4 = SYSTIME 

63490 

F802 

LFACT 

Line feed active or not; 
0 = No 1 = Yes 

63491 

F803 

NULAF 

Number of NULU following CR/LF: 

0 = None 

1 = TWo 

2 = Five 

3 r Ten 

4 = Twenty 

63492 

F804 

ECHOF 

Ihe serial output echo flag; 

0 = No echo (Full Duplex) 

1 = Output echoed to HUNTER'S screen 

63493 

F805 

RXPROT 

Receive protocol (as TXPROT), 

63494/63496 

F807/F808 CTSVECT 

CTS interrupt vector. These locations 
contain an address for the CTS input. 

63502 

F80E 

ESCODE 

Escape code. Used when escaping from 
fully running code. Used to interrupt 
execution of user programs when Basic 
auto-start is in use. ASCII characters 
are stored in Decimal form, most 
significant digit at lowest memory 
location. ^ 

63507 

F813 

STARTFL 

Flag to indicate immediate runnine of 
user Basic program. 

AAH r Immediate run. 

63551/63552 

F83F/ 

F840 

ALIM 

Address of the lower limit of Basic 
Symbol table End of free Memory. 

63553/63554 

F8M1/ 

F842 

DEFLIM 

Beginning of free memory after Basic 
source and arrays. 
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Lcxiation 

(Decimal) 

63563 

Location 

(Hex) 

F84B 

Name 

SERIG 

Function 

This contains the ASCII code of a 
character to ignore when receiving 
serial data. If not required set to 
BOH (128 decimal). 

63571 

F853 

RECLEN 

This is a single byte defining maximum 
record length. (See section 6.7) 

63572 

F854 

BUFLEN 

This is a two byte number defining 
maximum block length. (See section 6.7) 

63574 

F856 

SRFLG 

This flag controls single or multiple 
records in a block. (See section 6.7) 

63575 

F857 

RPFLG 

A single byte flag used to control 
record padding. (See section 6.7) 

63576 

F858 

EMFLG 

Determines essential differences 
between 2780 and 3780 communications. 
(See section 6.7) 

63577 

F859 

STXLFG 

A single byte flag controlling use of 
intermediate STXs. (See section 6.7) 

63578 

F85A 

RETRYS 

A single byte flag controlling error 
handling by the protocol. (See section 
6.7) 

63579 

F85B 

SCFLG 

A single byte flag controlling 
operation of space compression. (See 
section 6.7) 

63584 

F860 

BARTYP 

Select Bar code type 
0=C0DE 39 
1=EAN8/13 

63585 

F861 

TOPAGE 

Maximum number of pages in HUNTER. 
Note: Bit 7 is set to indicate "RAM". 

63889 

F991 

LSTBSN 

CAPS lock 0=0FF 1=ON 
Note: nwst be 0 or 1 

65266 

FEF2 

KEYBUF 

112 bytes of keyboard RAM, see section 


9.6, KEYBOARD MEMORY MAP. 
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Location 

(Decimal) 

Location 

(Hex) 

Name 

Function 

65378 

FF62 

SPELFLG 

Keyboard changed flag 
1=changed keyboard layout 

63420 

F7BC 

COMERR 

Location which maintains the error code 
for a coniTBjnications error. This 
location is normally clean. 

63581 

F85D 

RXTOAF 

timeout active (parameters as 

TXTOAF). 

63582 

F85E 

TXTOAF 

Transmit timeout active 




0 = no timeout 

1 = 10 sec timeout 4 = HO sec timeout 

2 = 20 sec timeout 5 = 50 sec timeout 

3 = 30 sec timeout 6 = 60 sec tineout 
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9.8 


PORT ALLOCATIONS 




Address Name 

Decimal Hex 


Description 


1 

1H 

DSR 

Bit seven Is the DSR Input 
bit. 

1 = Inactive 

2 = Active 

2 

2H 

INPUTS 

This port has a number of 
Input functions: 

Bit 0 s Data In (Inverted 
from RS-232 line) 

Bit 1 = DCD - »» - 
Bit 2 r Power low warning 
1 = Power O.fC 
0 = Power low 

Bit 3 = TXCLK - « - also the 
single input bit. 

96 

60H 

ANCLE 

Controls display viewing 
angle. Input value in the 
range 0-1 FH 

129 

81H 

V240UT 

Directly outputs to the V2U 
data line signal on bit 0. 
The output Is voltage 
Inverted l.e. 

0 = +Ve 1 = -VE 

130 

82H 

RTS 

RTS output bit 

131 

83H 

PnWHLD 

Power control 

bit 0 = 1 : HUt/TER on 

bit 0 = 0 : HUNTER off 

132 

8i<H 

INVCON 

V2i1 Inverter control 
bit 0 s 1 : Inverter on 
bit 0=0: inverter off 

133 

85H 

DTR 

DTR output bit 
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135 87H AUXPWR Turns on the auxilary 

power to pin 10 on the D 
type connector 
1 = Power on 
0 = Power off 


187 

BBH 

ICRPFG 

NSC800 internal interrupt 
mask register. See NSC800 




hand book. 

224 

EOH 

PAGE 

Memory paging register 
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9.9 


9.9.1 


SINGLE BIT INPUT PORT 


The single input bit has been implemented for use with devices 
such as bar-code wands, voltage free switch contacts, etc. It 
is provided via the 4 pin LEMO socket pin 2, Note should be 
made that it is shared with the TXCLK on the V24 interface (pin 
lb;. It should not, therefore, be used at the same time as the 
communications when hardware handshaking is in use. 

CIRCUIT IMPLEMENTATION 

configured as a protected, pulled up CMOS 
compatible line: 

Fig 9. 1 CIRCUIT UYOUT 



It has a logic 1 threshold of > 3.5V and a logic 0 < 1.5V. It is 
protected to ±25V. 

The pull-up resistor enables the use of a switch to ground to 
provide the input. 

No debounce circuitry is provided. If it is required then 
software must be written for this purpose. 

This is bit 3 on I/O port 2. See 9.8 
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Connector as seen on Hunter 
1 Bed dot 


Fig 9.2 PIN-OUT OF LEMO CONNECTOR 


PIN NO 

SIGNAL 

1 

GROUND 

2 

TX CLK or input 

3 

Charger/ reset 

4 

5V output (Wand option only) 
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9.9.3 LEMO CONNECTOR 

The four pin LEMO plug is installed by aligning the red mark on 
the plug sleeve with the corresponding red mark on HUNTER'S LEMO 
socket, the square pin on the plug body must also align with the 
key-way on the socket. The LEMO plug is then pushed firmly into 
HUNTER'S socket until the outer sleeve of the plug is flush with 
the casing of HUNTER'S LEMO socket. 

9. 9.3.1 Removal of LEMO Plug 

To remove the LEMO plug from HUNTER it is necessary to pull back 
the spring loaded outer sleeve before pulling the plug out of 
HUNTER'S socket. 
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9.10 

9 . 10.1 


9.10.2 


RS232 CONNECTOR 


The 25 way D type connector is used for connecting standard 
serial devices using RS 232 to HUNTER. 



Connector Type 

The connector is of the male type. It should only be used with 
standard female types. 


9.10.3 Connector Locking 

Two locking tabs are provided. These may be used to secure the 
mating connector securely. 

Recommended clips are: 

D53018 ITT Canon 

For a full explanation of the use of these signals, see section 
6 COMMUNICAHONS. 
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HEX DATA FORMAT 


9.11 HUNTER provides the industry standard 'Intel Hex' data format 

compatible with most CP/M computers. .COM files may be 
converted to .HEX files with the UNLOAD utility in the host 
machine, and then 'pipped' out. 

The data is split into blocks with leader and trailer 
information and the data in between. Each data block contains 
the memory locations into which the data is to be placed. 

A single block of data appears as:- 

:BBAAAA0ODD DDCC 

where BB = No of data bytes 
AAAA = Address of block 
00 = Null record 
DD = Data byte 
CC = Checksum 

Each byte is composed of two ASCII hexadecimal characters (0-9 
and A-F) 

The record starts with a colon which is detected by the 
receiving system. This is followed by a count of the data 
bytes, the starting address, a delimeter, the data itself and a 
ched<sum on the end. 

The checksum is calculated as the twos complement of the modulo 
256 addition of all the preceding bytes. 

The transmission is ended with a block of zero length. 

: 0000000000 

9.11.1 ERROR MESSAGES 

When loading HUNTER the address of the information i.s checked to 
ensure that it has written to the useable address space of the 
physical memory. Also the checksum is checked. If either of 
these checks fails, then an error message is displayed. 

* • Memory overflow * * 
or 

* • * Loading Error • » « 
as appropriate. 
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Reception at the end of record gives: 

• • Loading completed • * 

The loading may be aborted at any time by pressing ESC. 

The length of input data records is optional and is specified by 
the record up to 255 bytes. 

9.11.2 HEX TRANSMISSION 

The length of the record is fixed at sixteen data bytes. To 
start the transmission HUNTER awaits the ENTER key to ensure 
that all connections have been made. The data may be echoed 
onto the screen to verify active transmission. The transmission 
may be aborted by pressing ESC. 

9.11.3 LOADING MACHINE CODE PROGRAMS 

The Hex data fohmat will load any object code into memory. This 
may then be executed using the CALL statement in Basic, or 
loaded into a file with the file manager. 
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9.12 


ASCII TO EBCDIC CONVERSION 




(all values are in Hex) 


ASCII 


00 

01 

02 

03 

04 

05 

06 

07 

08 

09 
OA 
CB 
OC 
OD 
OE 
OF 

10 
11 
12 

13 

14 

15 

16 

17 

18 
19 
1A 
IB 
1C 
ID 
IE 
IF 


CHAR 


NULL 

SOH 

STX 

ETX 

EOT 

ENQ 

ACK 

BEL 

BS 

HT 

LF 

VT 

FF 

CR 

50 

51 
DLE 
DC1 
DC2 
DCS 
DC4 
NAK 
SYN 
ETB 
CAN 
EM 
SUB 
ESC 
FS 

ns 

RS 

US 


EBCDIC 


00 

01 

02 

03 

37 

2D 

2E 

2F 

16 

05 

25 

OB 

OC 

OD 

OE 

OF 

10 

11 

12 

13 

14 
3D 
32 
26 
18 
19 
3F 
27 
22 
ir 
IE 
IF 


ASCII 


20 

21 

22 

23 

24 

25 

26 

27 

28 

29 
2A 
2B 
2C 
2D 
2E 
2F 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 
3A 
3B 
3C 
3D 
3E 
3F 


CHAR 


SPACE 

I 

HEX 

$ 

t 

& 

I 

( 

) 


EBCDIC 


40 

5A 

7F 

7B 

5B 

6C 

50 

7D 

4D 

5D 

5C 

4E 

6B 

60 

4B 

61 

FO 

FI 

F2 

F3 

F4 

F5 

F6 

F7 

F8 

F9 

7A 

5E 

4C 

7E 

6E 

6F 
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1 ASCII 

CHAR 

EBCDIC 

ASCII 

CHAR 

EBCDIC 

40 

e 

7C 

60 

\ 

79 

41 

A 

Cl 

61 

a 

81 

42 

B 

C2 

62 

b 

82 

43 

C 

C3 

63 

c 

83 

44 

D 

C4 

64 

d 

84 

45 

E 

C5 

65 

e 

85 

46 

F 

C6 

66 

f 

86 

47 

G 

C7 

67 

g 

87 

48 

H 

C8 

68 

h 

88 

49 

I 

C9 

69 

1 

89 

4A 

J 

D1 

6A 

j 

91 

4B 

K 

D2 

6B 

k 

92 

4C 

L 

D3 

6C 

1 

93 

4D 

M 

D4 

6D 

m 

94 

4E 

N 

D5 

6E 

n 

95 

4F 

0 

D6 

6F 

0 

96 

50 

P 

D7 

70 

p 

97 

51 

Q 

D8 

71 

q 

98 

52 

R 

D9 

72 

r 

99 

53 

S 

E2 

73 

s 

A2 

54 

T 

E3 

74 

t 

A3 

55 

U 

E4 

75 

u 

A4 

56 

V 

E5 

76 

V 

A5 

57 

W 

E6 

77 

w 

A6 

58 

X 

E7 

78 

X 

A7 

59 

Y 

E8 

79 

y 

A8 

5A 

Z 

E9 

7A 

z 

A9 

5B 

[ 

00 

7B 

{ 

CO 

5C 


EO 

7C 

6A 

5D 

5E 

5F 

] 

00 

5F 

6D 

— 

7D 

7E 

7F 

} 

DEL 

DO 

A1 

07 


- 
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FOUR OCTAVE SOUND RANGE 


Note 

Frequency 

(Hz) 

Pitch 

Parameter 

C 

138.810 

493 

D 

146.830 

439 

E 

164.810 

391 

F 

174.610 

368 

G 

196.000 

326 

A 

220.000 

290 

B 

246.940 

260 

C 

261.630 

244 

D 

293.660 

217 

E 

329.630 

193 

F 

349.230 

182 

G 

329.000 

162 

A 

440. 000 

144 

B 

493.880 

128 

Middle C 

523.250 

121 

D 

587.330 

107 

E 

659.260 

95 

F 

698.460 

90 

G 

783. 990 

80 

A 

880.000 

71 

B 

987.770 

63 

C 

1046.500 

59 

D 

1174.700 

52 

E 

1318.500 

46 

F 

1396.900 

43 

G 

1568.000 

38 

A 

1760.000 

34 

B 

1975.000 

30 

C 

2092. 000 

28 
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9.14 


9.14.1 


9.14.2 


This appendix describes the installation 
of common commercial CP/M programs, 
installation is to configure the program 
control codes within HUNTER. 


procedure for a number 
The purpose of the 
to the screen handling 


The control codes used by the HUNTER screen are. 


a) 

Clear Screen 

01H 

b) 

Home Cursor 

02H 

c) 

Cursor Addressing 

OFH, 

d) 

Cursor Right 

OCH 

e) 

Cursor Left 

08H 

f) 

Cursor up 

OBH 

g) 

Cursor down 

OAH 


The installation procedure is generally carried out on a 
standard CP/M desk-top machine prior to down-loading 
information, see Section 3.6 


MBASIC 

Standard disk-based Microsoft Basic can be down-loaded into 
HUNTER with no installation or modification. 

The only file to transfer is MBASIC.COM. MBASIC may now be run. 
WORDSTAR VERSION 2 

The standard disk from MicroPro has the following files: 


INSTALL.COM 
WSU.COM 
WSMSGS.OVR 
WS0VLY1 .OVR 

The INSTALL program is used to configure the main Wordstar 
program WSU.CCM or an existing Wordstar file (WS.COM). 

The two overlay files, WSMSGS.OVR and WS0VLY1.0VR, do not need 
any alteration. 

When using the INSTALL program, refer to the Wordstar manual for 
further information - INSTALL is faily self explanatory. The 
main features of the procedure are explained below: 


1) Type INSTALL to load and run INSTALL on your desk-top unit. 

2) Select the appropriate Wordstar file, e.g. WSU.CCM. 
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3) 

4) 

5) 


Terminal MENU : select "Z” for "none of the above." This 
will be described later when patching in the exact controls. 

printer - typically, 

selection A will be compatible with most types of printer. 

menu ! select H", this will enable 
pr^Mol cofninunications package to handle any necessary 


6) Driver MENU ; select "L" for the standard CP/M list device. 

7) You are now prompted for: 


ARE MODIFICATIONS TO WORDSTAR NOW CCMPLETE?: 

^swer "N" for No, m it is now necessary to patch the codes 
for the terminal selection. 

INSTALL will prompt with: 


LOCATION TO BE CHANGED (0=END):0248 
ADDRESS :0248H OLD VALUE :00H NEW VALUE: 18 


efu entered. This procedure should be repeated for 

the following locations: 


LOCATION (Hex) 

0248 

0249 
024A 
024B 
0253 
0258 
025D 
025E 
025F 
0260 
0264 
02AA 


New Value (Hex) 

18 

50 

01 

OF 

00 

00 

FF 

00 

00 

00 

00 

00 


FUNCTION 

Screen Height (24 lines) 
Screen width (80 characters) 
Clear screen 
Cursor positioning 

II 

II 

II 

II 

n 

It 

Inhibit scrolling 


After engineering these patches, terminate the 
entering 0 when the next location is requested. 


procedure by 


VER.V09F 


PAGE 9-51 


APPEJDIX 


SECTION 9.1^ 


CONFIGURING TYPICAL CP/M PROGRAMS 


9.1M.3 


After confirming the selections and exting from INSTALL, the 
three files; 


WS.COM 
WSMSGS.OVR 
WS0VLY1 .OVF 

are ready to be loaded and run, see Section 3.6 for details of 
the prcxiedure. 


SuperCalc Version 1 

The standard disk from Sorcim has the following files. 


INSTALL.COM 

SC.COM 

SC.OVL 

SC.HLP 


The INSTALL program is used to configure the main pro^gram 
SC.COM. The two other files SC.OVL and SC.HLP do not need any 
alteration. 


It will be helpful to refer to the SuperCalc manual when using 
INSTALL. 


However, below is set out the response to each menu choice to 
install for the HUNTER, after running the "INSTALL.COM" program. 


a) Terminal Selection Menu 

No automatic installation is provided for HUffTER. Type in 
•x' (not specified on the screen) for manually setting up 
the various options. 

A second menu is displayed showing options A-F. Each option 
should be configured as described. 

A. EDIT SCREEN CONTROLS 


Another menu is displayed. Choose each option in turn and 
modify as prompted until the following is displayed: 

1 Clear Screen : 1,01 

2 Clear to EOL : Unconfigured 

3 Hone cursor : Unconfigured 


Return to the main selection and run by pressing x. 
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No configuring is necessary. Each option should be: 


edit INPUT KEYS 


attribute : Unconfigured 
it ( t A attribute ; Unconfigured 

attribute : Unconfigured 
Clear (end) Border attribute : Unconfigured 


jey CO input for -up : K (Control K) 

Key to input for -down : J 

Key to input for -left : H 

Key to input for -right ; L 

Key to input for Help : No help key 


EDIT GOTO XY, PRINTER INIT. STRING 

1 Printer init. string 
leave unconfigured 

2 Goto XY routine (for cursor addressing) 

type in the following string of bytes: 

D5, 3E, OF, CD, 7D, 01, D1, DS, 7B D6 Pfi fin 
CD, 7D, 01, Dl, 7A; D6! 20! Vs] 80,* o?’ °* 

EDIT MISCELUNEOUS DATA 


0 

1 

2 

3 

4 

5 

6 

7 

8 
9 


Display Border Character 
No. of video lines (down) 

No. of video columns (across) 
No. of printer lines 
No. of printer columns 
Dumb terminal cursor brackets 
Left = ”<" Right = »>'• 

CPU frequency (in lOOOs Hz) 
Baud rate used (for delays) 
No. of CRT attribute 
Use printer status (in BIOS) 
(1 = yes, 0 = no) 


-7Ch 

-12 

-ilO 

-66 

-132 


-ilOOO 

-12 

-0 

-1 
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F. EDIT TERMINAL NAME 

Enter name = Hu^y HUNTER 

Then type X to finish editing data, and A to save SuperCalo 
on di^. 

The files: 

SC.COM 

SC.OVL 

SC.HLP 


are now complete. 


9.14.4 


Loading dBASE Programs 


The well known data base package, dBASE II, can be installed to 
run on the HUNTER. Described below is the sequence of 
to the install program to give full functions to the software 
package. 


The version described is V2.3B, which is supplied as 13 
individual files. They are: 


DBASE.COM 

DBASEMSG.COM 

DBASEMAI.OVR 

DBASEAPP.OVR 

DBASEBRO.'OVR 

DBASEJOI.OVR 


DBASEMOD.OVR 

DBASEMSC.OVR 

DBASERPG.OVR 

DBASESRT.OVR 

DBASETTL.OVR 

DBASEUPD.OVR 

INSTALL.COM 


The first three files are vital to any dBASE program, but the 
rest are separate overlay files each supporting a particular 
function. 


For example, if a sort facility is required, then the 
DBASESRT.OVR file will be required on the HUNTER. 


9.14.5 Installing dBASE 

On your host CP/M machine, type: 
INSTALL 

to run the install program. 
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The first question will ask whether you require full screen 
operations. 

Type »Y' 

A menu of diferent types of VDU will then appear. 

Select 'Z» 

for user supplied terminal commands. 

The next question refers to the type of data to be entered. All 
data will be in hex, so answer accordingly. 

1. DELETE A CHARACTER SEQUENCE 

The correct sequence is 03,00,20 

2. DIRECT CURSOR POSITIONAL SEQUENCE 

Column nuntoer position = 02 
Line number position = 03 
Constant bias = 00 

The skeleton is OF, 00, 00 

3. CLEAR AND HOME SCREEN COMMANDS 
01 

4. BRIGHT/STD VIDEO COMMANDS 
None 

5. DIM/REVERSE VIDEO COMMANDS 
None 

6. INITIALISAHON SEQUENOE 
None 

7. EXIT SEQUENCE 
01 

8. RESET TO STANDARD VIDEO MODE 
None 
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9. ALTER SCREEN SIZE 

Screen width = ^0 
Nim4>er of lines = 08 

Completion of Installation 

To complete installing, default the macro character to "4" and 
key-in a space for no error dialogue. 

The CP/M operating system is version 2. 2. , therefore: 

Enter "A" 

to compleU the installation. The above files are now ready for 
installation. 
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9.15 


Read Console Buffer 


CP/M call 10, Read Console Buffer, 
facilities. 


has a range of additional 


aoar^sM by roisters DE. Console input is terminated when either 
the buffer overflows, or on control J or control M. 


The Read buffer is of the form: 


DE I +0 I +1 I +2 I +3 I ! f5 I 1^1 

I mx I nc I cl I c2 I c3 I c^4 | | ?? | 

mx is maximum number of characters the buffer will hold (1 to 


loxxoweo oy Li, etc., the characters read from the console. 

If nc < mx then uninitialised positions follow the last character 
(represented above by ?). 


A nunber of control functions are recognised during line edit: 


Control C 
Control E 
Control H 
Control J 
Control M 
Control R 
Control X 


reboots system if at start of line 
causes physical end of line 
backspace one character position 
terminate input 
terminate input 

retype current line after new line 
backspaces to beginning of current line 
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NDEX 


10.1 

10.2 

10.3 
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